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

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

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

構文

LSA_CREATE_LOGON_SESSION LsaCreateLogonSession;

NTSTATUS LsaCreateLogonSession(
  [in] PLUID LogonId
)
{...}

[in] LogonId

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

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

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

リターンコード	説明
STATUS_LOGON_SESSION_COLLISION	指定されたログオン ID は、別のログオンセッションで既に使用されています。

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

認証パッケージがユーザーを認証するかどうかを決定するときに不要なログオンセッションを作成する場合は、 DeleteLogonSession を呼び出して削除する必要があります。認証に失敗した場合、認証パッケージは関連するすべてのログオンセッションを削除する必要があります。

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