ホーム › Security.Authentication.Identity › PLSA_CONVERT_AUTH_DATA_TO_TOKEN

PLSA_CONVERT_AUTH_DATA_TO_TOKEN

コールバック

シグネチャ

NTSTATUS PLSA_CONVERT_AUTH_DATA_TO_TOKEN(
    void* UserAuthData,
    DWORD UserAuthDataSize,
    SECURITY_IMPERSONATION_LEVEL ImpersonationLevel,
    TOKEN_SOURCE* TokenSource,
    SECURITY_LOGON_TYPE LogonType,
    LSA_UNICODE_STRING* AuthorityName,
    HANDLE* Token,
    LUID* LogonId,
    LSA_UNICODE_STRING* AccountName,
    INT* SubStatus
);

パラメーター

フィールド	型	説明
UserAuthData	void*	GetAuthDataForUser 関数または GetUserAuthData 関数から受け取った認可データへのポインター。
UserAuthDataSize	DWORD	UserAuthData パラメーターで指定された認可データのサイズ (バイト単位)。
ImpersonationLevel	SECURITY_IMPERSONATION_LEVEL	作成するトークンの偽装レベルを指定する SECURITY_IMPERSONATION_LEVEL 値。
TokenSource	TOKEN_SOURCE*	トークンに記録するソースを指定する TOKEN_SOURCE 構造体へのポインター。
LogonType	SECURITY_LOGON_TYPE	トークンに記録するログオンの種類を示す SECURITY_LOGON_TYPE 値。
AuthorityName	LSA_UNICODE_STRING*	このユーザーを認可した機関の名前 (通常はドメイン名) を指定する UNICODE_STRING 構造体へのポインター。
Token	HANDLE*	ユーザートークンのハンドルを受け取る HANDLE へのポインター。ユーザートークンの使用が終わったら、CloseHandle を呼び出してハンドルを解放してください。
LogonId	LUID*	トークンのログオン識別子を受け取る LUID へのポインター。
AccountName	LSA_UNICODE_STRING*	UserAuthData パラメーターにエンコードされているアカウント名を受け取る UNICODE_STRING 構造体へのポインター。
SubStatus	INT*	関数呼び出しの戻り値に関する追加情報を受け取る変数へのポインター。

公式ドキュメント

ConvertAuthDataToToken 関数は、 GetAuthDataForUser 関数または GetUserAuthData 関数から返された認可データからアクセストークンを作成します。

戻り値

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

関数が失敗した場合、戻り値は失敗の理由を示す NTSTATUS コードです。

解説(Remarks)

ConvertAuthDataToToken 関数へのポインターは、 LSA_SECPKG_FUNCTION_TABLE 構造体に用意されています。この構造体は SpInitialize 関数で受け取ります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)