PFSCE_QUERY_INFO コールバック関数 (scesvc.h)

  • [アーティクル]

PFSCE_QUERY_INFO コールバック関数は、セキュリティ構成ファイルまたは分析データベースからサービス固有の情報を照会します。

構文

PFSCE_QUERY_INFO PfsceQueryInfo;

SCESTATUS PfsceQueryInfo(
  [in]           SCE_HANDLE sceHandle,
  [in]           SCESVC_INFO_TYPE sceType,
  [in, optional] LPTSTR lpPrefix,
  [in]           BOOL bExact,
  [out]          PVOID *ppvInfo,
  [out]          PSCE_ENUMERATION_CONTEXT psceEnumHandle
)
{...}

パラメーター

[in] sceHandle

種類: SCE_HANDLE

ISceSvcAttachmentData::Initialize の呼び出し中に設定されたセキュリティ構成ツールによって添付ファイルに渡される不透明なハンドルを指定します。 このハンドルは、クエリされた情報を格納するために使用されます。

[in] sceType

種類: SCESVC_INFO_TYPE

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

値 意味
SCE_SERVICE_CONFIGURATION_INFO
 データベースに構成情報を要求します。
SCE_SERVICE_ANALYSIS_INFO
 データベースに分析情報を要求します。

[in, optional] lpPrefix

種類: LPTSTR

クエリを制限するためのプレフィックスまたはキー ( bExact を参照) を指定します。 文字列を指定すると、その文字列に一致するキー (および対応する値) のみが返されます。 NULL に設定すると、すべてのキーが返されます。

[in] bExact

種類: BOOL

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

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

[out] ppvInfo

種類: PVOID*

次のいずれかの構造体へのポインターを返します。 セキュリティ構成ツール セット (添付ファイルではない) は、情報のバッファーを割り当てます。したがって、このポインターは NULL を指す必要があります。

値 意味
SCESVC_CONFIGURATION_INFO
 sceType が SCE_SERVICE_CONFIGURATION_INFO に設定されている場合。
SCESVC_ANALYSIS_INFO
 sceType が SCE_SERVICE_ANALYSIS_INFO に設定されている場合。

[out] psceEnumHandle

種類: PSCE_ENUMERATION_CONTEXT

この関数の連続した呼び出しで使用できるハンドルを返します。 存在する可能性があるキーの数が多いため、すべてのキーが 1 回の呼び出しで返されるわけではありません。 1 回の呼び出しで返されるキーの最大数は 256 です。

戻り値

種類: SCESTATUS

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

リターン コード 説明
SCESTATUS_INVALID_PARAMETER
 関数に渡されたパラメーターの 1 つが無効でした。
SCESTATUS_RECORD_NOT_FOUND
 指定したレコードがセキュリティ データベースに見つかりませんでした。
SCESTATUS_BAD_FORMAT
 形式が無効です。
SCESTATUS_OTHER_ERROR
 特定できないエラーが発生しました。
SCESTATUS_NOT_ENOUGH_RESOURCE
 メモリが不足しています。

注釈

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

例

例 : 参照先
構成情報の取得 SceSvcAttachmentConfig の実装
分析情報の取得 SceSvcAttachmentAnalyze の実装
構成と分析情報の取得 SceSvcAttachmentUpdate の実装
 

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー scesvc.h

こちらもご覧ください

PFSCE_FREE_INFO

SCESVC_ANALYSIS_INFO

SCESVC_CONFIGURATION_INFO