SpInitUserModeContextFn コールバック関数 (ntsecpkg.h)

  • [アーティクル]

SpInitUserModeContext 関数は、パックされたローカル セキュリティ機関 (LSA) モード のコンテキストからユーザー モードのセキュリティ コンテキストを作成します。

構文

SpInitUserModeContextFn Spinitusermodecontextfn;

NTSTATUS Spinitusermodecontextfn(
  [in] LSA_SEC_HANDLE ContextHandle,
  [in] PSecBuffer PackedContext
)
{...}

パラメーター

[in] ContextHandle

SpInitLsaModeContext または SpAcceptLsaModeContext 関数から返される LSA モード コンテキストへのハンドル。

[in] PackedContext

シリアル化されたコンテキスト データを含む SecBuffer 構造体へのポインター。 FreeContextBuffer 関数を使用して、この構造体に割り当てられたメモリを解放します。

戻り値

関数が成功した場合は、STATUS_SUCCESSを返します。

関数が失敗した場合は、失敗した理由を示す NTSTATUS コードを返します。 次に、失敗の一般的な理由と、関数が返すエラー コードを示します。

リターン コード 説明
STATUS_INSUFFICIENT_RESOURCES
 コンテキストを作成するためのメモリが不足しています。

注釈

SpInitLsaModeContext または SpAcceptLsaModeContext の MappedContext パラメーターが TRUE に設定されている場合、セキュリティ パッケージによってセキュリティ コンテキストが作成された後に SpInitUserModeContext 関数が呼び出されます。 パッケージ固有のコンテキスト データには、 SpInitUserModeContext の呼び出しの結果となった関数を特定するために必要な情報が含まれている必要があります。

SSP/AP は SpInitUserModeContext 関数を実装する必要があります。ただし、実装に与えられる実際の名前は開発者次第です。

SpInitUserModeContext 関数へのポインターは、SpUserModeInitialize 関数から受信したSECPKG_USER_FUNCTION_TABLE構造体で使用できます。

要件

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

こちらもご覧ください

SECPKG_USER_FUNCTION_TABLE

SpAcceptLsaModeContext

SpInitLsaModeContext

SpUserModeInitialize