LSA_CREATE_TOKEN_EX コールバック関数 (ntsecpkg.h)
SpAcceptLsaModeContext の呼び出しの処理中にトークンを作成します。
構文
LSA_CREATE_TOKEN_EX LsaCreateTokenEx;
NTSTATUS LsaCreateTokenEx(
[in] PLUID LogonId,
[in] PTOKEN_SOURCE TokenSource,
[in] SECURITY_LOGON_TYPE LogonType,
[in] SECURITY_IMPERSONATION_LEVEL ImpersonationLevel,
[in] LSA_TOKEN_INFORMATION_TYPE TokenInformationType,
[in] PVOID TokenInformation,
[in] PTOKEN_GROUPS TokenGroups,
[in] PUNICODE_STRING Workstation,
[in] PUNICODE_STRING ProfilePath,
[in] PVOID SessionInformation,
[in] SECPKG_SESSIONINFO_TYPE SessionInformationType,
[out] PHANDLE Token,
[out] PNTSTATUS SubStatus
)
{...}
パラメーター
[in] LogonId
新しいトークンのログオン セッション識別子へのポインター。 この識別子は、 CreateLogonSession の以前の呼び出しから取得されます。
[in] TokenSource
このトークンのソースを指定する TOKEN_SOURCE 構造体へのポインター。 パッケージ名を指定します。
[in] LogonType
ログオンの種類を示す SECURITY_LOGON_TYPE 値。
[in] ImpersonationLevel
サーバー プロセスがクライアント プロセスを偽装できるエクステントを示す SECURITY_IMPERSONATION_LEVEL 値。
[in] TokenInformationType
TokenInformation パラメーターの構造体の型を指定します。
| 値 | 意味 |
|---|---|
|
|
|
[in] TokenInformation
トークン情報へのポインター。 TokenInformation によって指される構造体の型は、TokenInformationType パラメーターによって示されます。
[in] TokenGroups
TokenInformation に含まれていないグループを指定するTOKEN_GROUPS構造体へのポインター。
[in] Workstation
クライアントのワークステーションの名前 (通常は NetBIOS 名) を含む UNICODE_STRING構造体への ポインター。
[in] ProfilePath
ユーザーのプロファイルへのパスを含む UNICODE_STRING 構造体へのポインター (存在する場合)。
[in] SessionInformation
現在のログオン セッションに関する情報を指定するデータ。 このデータの形式は、 SessionInformationType パラメーターの値によって指定されます。
[in] SessionInformationType
SessionInformation パラメーターの形式を指定するSECPKG_SESSIONINFO_TYPE列挙の値。 現在、定義されている値は SecSessionPrimaryCred のみです。 これは、SessionInformation パラメーターの値が SECPKG_PRIMARY_CRED 構造体であることを指定します。
[out] Token
新しいトークンへのハンドルのアドレスを受け取るポインター。 ハンドルの使用が完了したら、 CloseHandle 関数を呼び出して閉じます。
[out] SubStatus
エラー情報を受け取る変数へのポインター。
戻り値
関数が成功した場合、戻り値はSTATUS_SUCCESS。
関数が失敗した場合、戻り値は失敗した理由を示す NTSTATUS コードです。
注釈
CreateTokenEx 関数へのポインターは、SpInitialize 関数によって受信されたLSA_SECPKG_FUNCTION_TABLE構造体で使用できます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | ntsecpkg.h |