SetTokenInformation 函式 (securitybaseapi.h)

發行項
03/05/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 列舉型別的值，可識別函式集的信息類型。 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