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