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 |