ログオン セッションを作成します。
ログオン セッションは、ログオン セッションに割り当てられた一意のログオン ID ( LUID) によって識別されます。
構文
LSA_CREATE_LOGON_SESSION LsaCreateLogonSession;
NTSTATUS LsaCreateLogonSession(
[in] PLUID LogonId
)
{...}
パラメーター
[in] LogonId
新しいログオン セッションに割り当てられる LUID 構造体へのポインター。 認証パッケージは、この ID を生成するために AllocateLocallyUniqueId を呼び出します。
戻り値
関数が成功した場合、戻り値はSTATUS_SUCCESS。
関数が失敗した場合、戻り値は NTSTATUS コードで、次の値または LSA ポリシー関数の戻り値のいずれかになります。
| リターン コード | 説明 |
|---|---|
|
指定されたログオン ID は、別のログオン セッションで既に使用されています。 |
LsaNtStatusToWinError 関数は、NTSTATUS コードを Windows エラー コードに変換します。
注釈
認証パッケージがユーザーを認証するかどうかを決定するときに不要なログオン セッションを作成する場合は、 DeleteLogonSession を呼び出して削除する必要があります。 認証に失敗した場合、認証パッケージは関連するすべてのログオン セッションを削除する必要があります。
ログオン セッションはカーネル内のメモリを使用するため、未使用または破棄されたログオン セッションを削除することが重要です。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | ntsecpkg.h |