ホーム › Security.Authentication.Identity › PLSA_DELETE_LOGON_SESSION
PLSA_DELETE_LOGON_SESSION
コールバックシグネチャ
NTSTATUS PLSA_DELETE_LOGON_SESSION(
LUID* LogonId
);パラメーター
| フィールド | 型 | 説明 |
|---|---|---|
| LogonId | LUID* | 削除するログオンセッションのセッション ID を格納した LUID 構造体へのポインター。 |
公式ドキュメント
ユーザーの認証情報が正当かどうかを判定する過程で作成されたログオンセッションをクリーンアップします。
認証に失敗した場合、認証パッケージは関連するすべてのログオンセッションを削除する必要があります。
戻り値
関数が成功した場合、戻り値は STATUS_SUCCESS です。
関数が失敗した場合、戻り値は NTSTATUS コードであり、次のいずれかの値、または LSA ポリシー関数の戻り値 のいずれかになります。
| 戻り値 | 説明 |
|---|---|
| 指定されたログオンセッションには、削除を妨げる参照カウント値が設定されています。これは、オペレーティングシステムと認証パッケージの両方が、そのログオンセッションを管理する権限を持っていると認識していることによって発生する重大な問題です。 | |
| 指定されたログオンセッションが見つかりませんでした。 |
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)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)