Win32 API 日本語リファレンス
ホーム › Security.Authentication.Identity › SpInitializeFn

SpInitializeFn

コールバック

シグネチャ

NTSTATUS SpInitializeFn(
    UINT_PTR PackageId,
    SECPKG_PARAMETERS* Parameters,
    LSA_SECPKG_FUNCTION_TABLE* FunctionTable
);

パラメーター

フィールド型説明
PackageIdUINT_PTRLSA が各セキュリティ パッケージに割り当てる一意の識別子です。この値はシステムが再起動されるまで有効です。
ParametersSECPKG_PARAMETERS*プライマリ ドメインおよびマシンの状態情報を格納する SECPKG_PARAMETERS 構造体へのポインターです。
FunctionTableLSA_SECPKG_FUNCTION_TABLE*セキュリティ パッケージが呼び出すことのできる LSA サポート関数のテーブルへのポインターです。

公式ドキュメント

SpInitialize 関数は、ローカル セキュリティ機関 (LSA) が、セキュリティ パッケージに一般的なセキュリティ情報とサポート関数のディスパッチ テーブルを提供するために一度だけ呼び出します。セキュリティ パッケージは、その情報を保存し、必要に応じて内部の初期化処理を行う必要があります。

戻り値

関数が成功した場合は、STATUS_SUCCESS または情報を示すステータス コードを返します。

関数が失敗した場合は、失敗の理由を示す NTSTATUS エラー コードを返します。詳細については、「解説」を参照してください。

解説(Remarks)

SpInitialize が NTSTATUS エラー コードを LSA に返した場合、そのパッケージはアンロードされ、ローカル セキュリティ機関 (LSA) は利用可能なセキュリティ パッケージの一覧にそのパッケージを含めません。

SSP/AP は SpInitialize 関数を実装する必要がありますが、実装に付ける実際の名前は開発者が決定できます。

SSP/AP による SpInitialize 関数の実装へのポインターは、 SpLsaModeInitialize 関数から LSA に渡される SECPKG_FUNCTION_TABLE 構造体に格納されている必要があります。

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