SetTokenInformation 関数 (securitybaseapi.h)

[アーティクル]
03/01/2024

SetTokenInformation 関数は、指定されたアクセストークンのさまざまな種類の情報を設定します。この関数が設定する情報は、既存の情報を置き換えます。呼び出し元プロセスには、情報を設定するための適切なアクセス権が必要です。

構文

BOOL SetTokenInformation(
  [in] HANDLE                  TokenHandle,
  [in] TOKEN_INFORMATION_CLASS TokenInformationClass,
  [in] LPVOID                  TokenInformation,
  [in] DWORD                   TokenInformationLength
);

パラメーター

[in] TokenHandle

情報を設定するアクセストークンのハンドル。

[in] TokenInformationClass

関数が設定 TOKEN_INFORMATION_CLASS 情報の種類を識別する列挙型の値。 TOKEN_INFORMATION_CLASSの有効な値については、TokenInformation パラメーターを参照してください。

[in] TokenInformation

アクセストークンに設定された情報を含むバッファーへのポインター。このバッファーの構造は、 TokenInformationClass パラメーターで指定された情報の種類によって異なります。

[in] TokenInformationLength

TokenInformation が指すバッファーの長さをバイト単位で指定します。

戻り値

関数が成功した場合、関数は 0 以外の値を返します。

関数が失敗すると、0 が返されます。詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

特権情報を設定するために、アプリケーションは AdjustTokenPrivileges 関数を呼び出すことができます。トークンのグループを設定するために、アプリケーションは AdjustTokenGroups 関数を呼び出すことができます。

トークンの種類の情報は、アクセストークンが作成された場合にのみ設定できます。

要件

要件	値
サポートされている最小のクライアント	Windows XP [デスクトップアプリ \| UWP アプリ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップアプリのみ \| UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	securitybaseapi.h (Windows.h を含む)
Library	Advapi32.lib
[DLL]	Advapi32.dll