共用方式為


SetTokenInformation 函式 (securitybaseapi.h)

SetTokenInformation 函式會設定指定存取令牌的各種信息類型。 此函式設定的資訊會取代現有的資訊。 呼叫進程必須具有適當的訪問許可權,才能設定資訊。

語法

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

參數

[in] TokenHandle

要設定資訊的存取令牌句柄。

[in] TokenInformationClass

TOKEN_INFORMATION_CLASS 列舉型 別的值,可識別函式集的信息類型。 TokenInformation 參數會說明來自 TOKEN_INFORMATION_CLASS的有效值。

[in] TokenInformation

緩衝區的指標,其中包含存取令牌中設定的資訊。 這個緩衝區的結構取決於 TokenInformationClass 參數所指定的資訊類型。

[in] TokenInformationLength

指定 TokenInformation 所指向之緩衝區的長度,以位元組為單位。

傳回值

如果函式成功,函式會傳回非零。

如果函式失敗,它會傳回零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError

備註

若要設定許可權資訊,應用程式可以呼叫 AdjustTokenPrivileges 函式。 若要設定令牌的群組,應用程式可以呼叫 AdjustTokenGroups 函式。

只有在建立存取令牌時,才可以設定令牌類型資訊。

規格需求

需求
最低支援的用戶端 Windows XP [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 securitybaseapi.h (包括 Windows.h)
程式庫 Advapi32.lib
Dll Advapi32.dll

另請參閱

存取控制 概觀

AdjustTokenGroups

AdjustTokenPrivileges

基本 存取控制 函式

GetTokenInformation

OpenProcessToken

OpenThreadToken

TOKEN_DEFAULT_DACL

TOKEN_INFORMATION_CLASS

TOKEN_OWNER

TOKEN_PRIMARY_GROUP