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

こちらもご覧ください

SECPKG_FUNCTION_TABLE

SECPKG_PARAMETERS

SpLsaModeInitialize