SpInitializeFn コールバック関数 (ntsecpkg.h)
SpInitialize 関数は、一般的なセキュリティ情報とサポート関数のディスパッチ テーブルをセキュリティ パッケージに提供するために、ローカル セキュリティ機関 (LSA) によって 1 回呼び出されます。 セキュリティ パッケージは情報を保存し、必要に応じて内部初期化処理を実行する必要があります。
構文
SpInitializeFn Spinitializefn;
NTSTATUS Spinitializefn(
[in] ULONG_PTR PackageId,
[in] PSECPKG_PARAMETERS Parameters,
[in] PLSA_SECPKG_FUNCTION_TABLE FunctionTable
)
{...}
パラメーター
[in] PackageId
LSA が各セキュリティ パッケージに割り当てる一意の識別子。 この値は、システムが再起動されるまで有効です。
[in] Parameters
プライマリ ドメインとマシンの状態情報を含む SECPKG_PARAMETERS 構造体へのポインター。
[in] FunctionTable
LSA のテーブルへのポインターは、セキュリティ パッケージが呼び出すことができる関数をサポートします。
戻り値
関数が成功した場合は、STATUS_SUCCESSまたは情報状態コードを返します。
関数が失敗した場合は、失敗した理由を示す NTSTATUS エラー コードを返します。 詳細については、「解説」を参照してください。
注釈
SpInitialize が NTSTATUS エラー コードを LSA に返した場合、パッケージはアンロードされ、ローカル セキュリティ機関 (LSA) はそれを使用可能なセキュリティ パッケージの一覧に含めなくなります。
SSP/AP は SpInitialize 関数を実装する必要があります。ただし、実装に与えられる実際の名前は開発者次第です。
SSP/AP の SpInitialize 関数の実装へのポインターは、SpLsaModeInitialize 関数から LSA に渡されるSECPKG_FUNCTION_TABLE構造体内にある必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | ntsecpkg.h |