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

  • [アーティクル]

PFSCE_SET_INFOコールバック関数は、サービス固有の構成と分析情報を設定または上書きします。

構文

PFSCE_SET_INFO PfsceSetInfo;

SCESTATUS PfsceSetInfo(
  [in]           SCE_HANDLE sceHandle,
  [in]           SCESVC_INFO_TYPE sceType,
  [in, optional] LPTSTR lpPrefix,
  [in]           BOOL bExact,
  [in]           PVOID pvInfo
)
{...}

パラメーター

[in] sceHandle

種類: SCE_HANDLE

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

[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 で指定された文字列は、一連のキーのプレフィックスを表します。 同じプレフィックスを持つすべてのキー (およびその値) が設定されます。

[in] pvInfo

種類: PVOID

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

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

戻り値

種類: SCESTATUS

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

リターン コード 説明
SCESTATUS_ACCESS_DENIED
 呼び出し元には、このアクションを完了するための十分な特権がありません。
SCESTATUS_BAD_FORMAT
 形式が正しくありません。
SCESTATUS_PREFIX_OVERFLOW
 バッファーが保持できるデータよりも多くのデータがあります。
SCESTATUS_INVALID_PARAMETER
 関数に渡されたパラメーターの 1 つが無効でした。
SCESTATUS_NOT_ENOUGH_RESOURCE
 メモリが不足しています。
SCESTATUS_OTHER_ERROR
 特定できないエラーが発生しました。
SCESTATUS_RECORD_NOT_FOUND
 指定されたレコードがセキュリティ データベースに見つかりませんでした。

要件

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

こちらもご覧ください

PFSCE_QUERY_INFO

SCESVC_ANALYSIS_INFO

SCESVC_CONFIGURATION_INFO