ホーム › Security.ConfigurationSnapin › PFSCE_SET_INFO

PFSCE_SET_INFO

コールバック

シグネチャ

DWORD PFSCE_SET_INFO(
    void* sceHandle,
    SCESVC_INFO_TYPE sceType,
    CHAR* lpPrefix,
    BOOL bExact,
    void* pvInfo
);

パラメーター

フィールド

型

説明

sceHandle

void*

ISceSvcAttachmentData::Initialize の呼び出し時に、セキュリティ構成ツールセットがアタッチメントに渡した不透明な SCE ハンドルを指定します。このハンドルは、情報の設定または上書きに使用されます。

sceType

SCESVC_INFO_TYPE

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

値	意味
SCE_SERVICE_CONFIGURATION_INFO	構成情報を設定することを示します。
SCE_SERVICE_ANALYSIS_INFO	分析情報を設定することを示します。

lpPrefix

CHAR*

設定または上書きする情報を指定します。この文字列には、特定のキー(bExact を参照)、またはキーの集合に対するプレフィックスを指定できます。文字列を指定した場合、その文字列に一致するキー(および対応する値)の情報のみが設定されます。NULL を指定した場合は、そのサービスのすべての情報が設定されます。

bExact

BOOL

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

次のいずれかの値を指定します。

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

pvInfo

void*

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

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

公式ドキュメント

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

戻り値

型: SCESTATUS

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

戻り値	説明
SCESTATUS_ACCESS_DENIED	呼び出し元に、この操作を完了するための十分な権限がありません。
SCESTATUS_BAD_FORMAT	形式が正しくありません。
SCESTATUS_PREFIX_OVERFLOW	バッファーが保持できる量を超えるデータがあります。
SCESTATUS_INVALID_PARAMETER	関数に渡されたパラメーターのいずれかが有効ではありませんでした。
SCESTATUS_NOT_ENOUGH_RESOURCE	メモリが不足しています。
SCESTATUS_OTHER_ERROR	原因不明のエラーが発生しました。
SCESTATUS_RECORD_NOT_FOUND	指定されたレコードがセキュリティデータベース内に見つかりませんでした。

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