ホーム › Security.Authentication.Identity › PLSA_CREATE_TOKEN_EX
PLSA_CREATE_TOKEN_EX
コールバックシグネチャ
NTSTATUS PLSA_CREATE_TOKEN_EX(
LUID* LogonId,
TOKEN_SOURCE* TokenSource,
SECURITY_LOGON_TYPE LogonType,
SECURITY_IMPERSONATION_LEVEL ImpersonationLevel,
LSA_TOKEN_INFORMATION_TYPE TokenInformationType,
void* TokenInformation,
TOKEN_GROUPS* TokenGroups,
LSA_UNICODE_STRING* Workstation,
LSA_UNICODE_STRING* ProfilePath,
void* SessionInformation,
SECPKG_SESSIONINFO_TYPE SessionInformationType,
HANDLE* Token,
INT* SubStatus
);パラメーター
| フィールド | 型 | 説明 | ||||||
|---|---|---|---|---|---|---|---|---|
| LogonId | LUID* | 新しいトークンのログオンセッション識別子へのポインターです。この識別子は、事前に CreateLogonSession を呼び出して取得します。 | ||||||
| TokenSource | TOKEN_SOURCE* | このトークンのソースを指定する TOKEN_SOURCE 構造体へのポインターです。パッケージ名を指定します。 | ||||||
| LogonType | SECURITY_LOGON_TYPE | ログオンの種類を示す SECURITY_LOGON_TYPE 値です。 | ||||||
| ImpersonationLevel | SECURITY_IMPERSONATION_LEVEL | サーバープロセスがクライアントプロセスを偽装できる範囲を示す SECURITY_IMPERSONATION_LEVEL 値です。 | ||||||
| TokenInformationType | LSA_TOKEN_INFORMATION_TYPE | TokenInformation パラメーターに指定する構造体の型を指定します。
| ||||||
| TokenInformation | void* | トークン情報へのポインターです。TokenInformation が指す構造体の型は、TokenInformationType パラメーターによって示されます。 | ||||||
| TokenGroups | TOKEN_GROUPS* | TokenInformation に含まれていないグループを指定する TOKEN_GROUPS 構造体へのポインターです。 | ||||||
| Workstation | LSA_UNICODE_STRING* | クライアントのワークステーション名(通常は NetBIOS 名)を格納する UNICODE_STRING 構造体へのポインターです。 | ||||||
| ProfilePath | LSA_UNICODE_STRING* | ユーザーのプロファイルへのパス(存在する場合)を格納する UNICODE_STRING 構造体へのポインターです。 | ||||||
| SessionInformation | void* | 現在のログオンセッションに関する情報を指定するデータです。このデータの形式は、SessionInformationType パラメーターの値によって指定されます。 | ||||||
| SessionInformationType | SECPKG_SESSIONINFO_TYPE | SessionInformation パラメーターの形式を指定する SECPKG_SESSIONINFO_TYPE 列挙型の値です。現在定義されている値は SecSessionPrimaryCred のみであり、これは SessionInformation パラメーターの値が SECPKG_PRIMARY_CRED 構造体であることを指定します。 | ||||||
| Token | HANDLE* | 新しいトークンのハンドルのアドレスを受け取るポインターです。ハンドルの使用を終えたら、CloseHandle 関数を呼び出して閉じてください。 | ||||||
| SubStatus | INT* | エラー情報を受け取る変数へのポインターです。 |
公式ドキュメント
SpAcceptLsaModeContext の呼び出しを処理する間に、トークンを作成します。
戻り値
関数が成功した場合、戻り値は STATUS_SUCCESS です。
関数が失敗した場合、戻り値は失敗した理由を示す NTSTATUS コードです。
解説(Remarks)
CreateTokenEx 関数へのポインターは、 LSA_SECPKG_FUNCTION_TABLE 構造体( SpInitialize 関数が受け取る構造体)から取得できます。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)