Win32 API 日本語リファレンス
ホーム › Security.Authentication.Identity › PLSA_DELETE_LOGON_SESSION

PLSA_DELETE_LOGON_SESSION

コールバック

シグネチャ

NTSTATUS PLSA_DELETE_LOGON_SESSION(
    LUID* LogonId
);

パラメーター

フィールド型説明
LogonIdLUID*削除するログオンセッションのセッション ID を格納した LUID 構造体へのポインター。

公式ドキュメント

ユーザーの認証情報が正当かどうかを判定する過程で作成されたログオンセッションをクリーンアップします。

認証に失敗した場合、認証パッケージは関連するすべてのログオンセッションを削除する必要があります。

戻り値

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

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

戻り値 説明
STATUS_BAD_LOGON_SESSION_STATE
指定されたログオンセッションには、削除を妨げる参照カウント値が設定されています。これは、オペレーティングシステムと認証パッケージの両方が、そのログオンセッションを管理する権限を持っていると認識していることによって発生する重大な問題です。
STATUS_NO_SUCH_LOGON_SESSION
指定されたログオンセッションが見つかりませんでした。

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

解説(Remarks)

ログオンセッションはカーネル内のメモリを消費するため、使用されていないログオンセッションや破棄されたログオンセッションは削除する必要があります。ただし、セッションのログオン ID が LSA に返された後は、そのログオンセッションを削除しないでください。LSA にログオン ID が渡された後(たとえば LsaApLogonUser の呼び出しの結果として渡された後)、LSA はそのログオンセッションに対する責任を自身が負うものとみなし、オペレーティングシステムが不要になった時点でそれを削除します。このとき LSA は LsaApLogonTerminated を呼び出して、セッションが削除されたことを認証パッケージに通知します。

一方、DeleteLogonSession によってログオンセッションが削除された場合、認証パッケージには通知されません。

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