IsTokenRestricted 函式 (securitybaseapi.h)

  • 發行項

IsTokenRestricted 函式會指出令牌是否包含受限制的安全性標識碼清單， (SID) 。

語法

BOOL IsTokenRestricted(
  [in] HANDLE TokenHandle
);

參數

[in] TokenHandle

要測試 之存取令牌 的句柄。

傳回值

如果令牌包含限制 SID 的清單，則傳回值為非零。

如果令牌不包含限制 SID 的清單，則傳回值為零。

如果發生錯誤，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

CreateRestrictedToken 函式可以藉由停用 SID、刪除許可權，以及指定限制 SID 的清單來限制令牌。 IsTokenRestricted 函式只會檢查限制 SID 的清單。 如果令牌沒有任何限制的 SID，IsTokenRestricted 會傳回 FALSE，即使令牌是由 CreateRestrictedToken 的呼叫所建立。

規格需求

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

另請參閱

存取控制 概觀

基本 存取控制 函式

CreateRestrictedToken