ホーム › Security.Authentication.Identity › SpInitUserModeContextFn

SpInitUserModeContextFn

コールバック

シグネチャ

NTSTATUS SpInitUserModeContextFn(
    UINT_PTR ContextHandle,
    SecBuffer* PackedContext
);

パラメーター

フィールド	型	説明
ContextHandle	UINT_PTR	SpInitLsaModeContext 関数または SpAcceptLsaModeContext 関数から返された LSA モードコンテキストへのハンドル。
PackedContext	SecBuffer*	シリアル化されたコンテキストデータを格納する SecBuffer 構造体へのポインター。この構造体に割り当てられたメモリを解放するには、 FreeContextBuffer 関数を使用します。

公式ドキュメント

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

戻り値

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

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

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

解説(Remarks)

SpInitUserModeContext 関数は、セキュリティパッケージによってセキュリティコンテキストが作成された後、 SpInitLsaModeContext または SpAcceptLsaModeContext の MappedContext パラメーターが TRUE に設定されている場合に呼び出されます。パッケージ固有のコンテキストデータには、どちらの関数が SpInitUserModeContext の呼び出しにつながったかを判断するために必要な情報を格納してください。

SSP/AP は SpInitUserModeContext 関数を実装する必要があります。ただし、実装に付ける実際の名前は開発者が自由に決められます。

SpInitUserModeContext 関数へのポインターは、 SpUserModeInitialize 関数から受け取る SECPKG_USER_FUNCTION_TABLE 構造体で取得できます。

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