Win32 API 日本語リファレンス
ホーム › Security.ConfigurationSnapin › PFSCE_QUERY_INFO

PFSCE_QUERY_INFO

コールバック

シグネチャ

DWORD PFSCE_QUERY_INFO(
    void* sceHandle,
    SCESVC_INFO_TYPE sceType,
    CHAR* lpPrefix,
    BOOL bExact,
    void** ppvInfo,
    DWORD* psceEnumHandle
);

パラメーター

フィールド型説明
sceHandlevoid*ISceSvcAttachmentData::Initialize の呼び出し時に、Security Configuration ツール セットがアタッチメントに渡した不透明なハンドルを指定します。このハンドルは、照会した情報を格納するために使用されます。
sceTypeSCESVC_INFO_TYPE

照会する情報の種類を指定します。次のいずれかのフラグを指定します。

値 意味
SCE_SERVICE_CONFIGURATION_INFO
 データベースから構成情報を要求します。
SCE_SERVICE_ANALYSIS_INFO
 データベースから分析情報を要求します。
lpPrefixCHAR*照会を限定するためのプレフィックスまたはキー(bExact を参照)を指定します。文字列を指定した場合は、その文字列に一致するキー(および対応する値)だけが返されます。NULL を指定した場合は、すべてのキーが返されます。
bExactBOOL

lpPrefix で指定された文字列を、特定のキーとして扱うか、プレフィックスとして扱うかを指定します。lpPrefix が NULL に設定されている場合、このパラメーターは無視されます。次のいずれかの値を指定します。

値 意味
TRUE
 lpPrefix で指定された文字列は、特定のキーを表します。そのキーに一致するレコードだけが返されます。
FALSE
 lpPrefix で指定された文字列は、プレフィックスを表します。このプレフィックスを持つすべてのキー(およびその値)が返されます。
ppvInfovoid**

次のいずれかの構造体へのポインターを返します。情報用のバッファーは、(アタッチメントではなく)Security Configuration ツール セットが割り当てます。そのため、このポインターは NULL を指している必要があります。

値 意味
SCESVC_CONFIGURATION_INFO
 sceType に SCE_SERVICE_CONFIGURATION_INFO が設定されている場合。
SCESVC_ANALYSIS_INFO
 sceType に SCE_SERVICE_ANALYSIS_INFO が設定されている場合。
psceEnumHandleDWORD*この関数への後続の呼び出しで使用できるハンドルを返します。存在するキーの数が多くなる可能性があるため、1 回の呼び出しですべてのキーが返されるわけではありません。1 回の呼び出しで返されるキーの最大数は 256 です。

公式ドキュメント

PFSCE_QUERY_INFO コールバック関数は、Security Configuration ファイルまたは分析データベースからサービス固有の情報を照会します。

戻り値

型: SCESTATUS

関数呼び出しの結果を示す SCESTATUS 値。関数が成功した場合は SCESTATUS_SUCCESS を返します。それ以外の場合は、次のいずれかのエラー値を返します。

戻り値 説明
SCESTATUS_INVALID_PARAMETER
 関数に渡されたパラメーターのいずれかが有効ではありませんでした。
SCESTATUS_RECORD_NOT_FOUND
 指定されたレコードがセキュリティ データベース内に見つかりませんでした。
SCESTATUS_BAD_FORMAT
 形式が有効ではありません。
SCESTATUS_OTHER_ERROR
 原因不明のエラーが発生しました。
SCESTATUS_NOT_ENOUGH_RESOURCE
 メモリが不足しています。

解説(Remarks)

PFSCE_QUERY_INFO が呼び出されると、Security Configuration ツール セットはバッファーを割り当てます。これらのバッファーを解放するには、返された情報が不要になった後で PFSCE_FREE_INFO を呼び出します。

例

例の内容 参照先
構成情報の取得 Implementing SceSvcAttachmentConfig
分析情報の取得 Implementing SceSvcAttachmentAnalyze
構成情報と分析情報の取得 Implementing SceSvcAttachmentUpdate
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)