ホーム › Security.Authentication.Identity › PLSA_CREATE_LOGON_SESSION

PLSA_CREATE_LOGON_SESSION

コールバック

シグネチャ

NTSTATUS PLSA_CREATE_LOGON_SESSION(
    LUID* LogonId
);

パラメーター

フィールド	型	説明
LogonId	LUID*	新しいログオンセッションに割り当てる LUID 構造体へのポインターです。認証パッケージは、この ID を生成するために AllocateLocallyUniqueId を呼び出します。

公式ドキュメント

ログオンセッションを作成します。

ログオンセッションは、そのログオンセッションに割り当てられた一意のログオン ID ( LUID) によって識別されます。

戻り値

関数が成功した場合、戻り値は STATUS_SUCCESS です。

関数が失敗した場合、戻り値は NTSTATUS コードであり、次の値または LSA ポリシー関数の戻り値のいずれかになります。

戻り値	説明
STATUS_LOGON_SESSION_COLLISION	指定されたログオン ID は、既に別のログオンセッションで使用されています。

LsaNtStatusToWinError 関数は、NTSTATUS コードを Windows のエラーコードに変換します。

解説(Remarks)

認証パッケージが、ユーザーを認証するかどうかを判断する過程で余分なログオンセッションを作成した場合は、 DeleteLogonSession を呼び出してそれらを削除する必要があります。認証に失敗した場合、認証パッケージは関連するすべてのログオンセッションを削除する必要があります。

ログオンセッションはカーネル内のメモリを使用するため、未使用または破棄されたログオンセッションを削除することが重要です。

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