NtPrivilegeCheck 函式 (ntifs.h)
NtPrivilegeCheck 保留供系統使用。
語法
__kernel_entry NTSYSCALLAPI NTSTATUS NtPrivilegeCheck(
[in] HANDLE ClientToken,
[in, out] PPRIVILEGE_SET RequiredPrivileges,
[out] PBOOLEAN Result
);
參數
[in] ClientToken
表示客戶端嘗試存取之令牌物件的句柄。 此句柄必須從通訊會話層取得,例如從 LPC 埠或本機命名管道取得,以防止可能的安全策略違規。
[in, out] RequiredPrivileges
PRIVILEGE_SET 結構的指標。 這個結構的 Privilege 成員是LUID_AND_ATTRIBUTES結構的數位。 在呼叫 SePrivilegeCheck之前,請使用 Privilege 陣列來指出要檢查的許可權集。 如果必須啟用所有許可權,請將 Control 成員設定為PRIVILEGE_SET_ALL_NECESSARY;如果啟用任何一個許可權就已足夠,或將它設定為零。
[out] Result
接收布爾值旗標,指出用戶端是否具有所有指定的許可權。 TRUE 值表示用戶端具有所有指定的許可權;否則會傳回 FALSE 的值。
傳回值
NtPrivilegeCheck 在成功完成時傳回STATUS_SUCCESS。 否則,它會傳回錯誤碼,例如下列。
傳回碼 | 描述 |
---|---|
STATUS_PRIVILEGE_NOT_HELD | 呼叫端沒有足夠的許可權可使用此特殊許可權的系統服務。 |
言論
存取令牌包含與令牌相關聯之帳戶所持有的許可權清單。 這些許可權可以啟用或停用;大部分預設為停用。 NtPrivilegeCheck 只會檢查已啟用的許可權。 若要取得存取令牌所持有之所有已啟用和停用許可權的清單,請呼叫 SeQueryInformationToken。
如需安全性和訪問控制的詳細資訊,請參閱 適用於驅動程式開發人員的 Windows 安全性模型,以及 Windows SDK 中這些主題的檔。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows XP |
標頭 | ntifs.h |
連結庫 | NtosKrnl.lib |
DLL | NtosKrnl.exe |