共用方式為


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

另請參閱

LUID_AND_ATTRIBUTES

PRIVILEGE_SET

SECURITY_SUBJECT_CONTEXT

SeAccessCheck

SeAppendPrivileges

SeFreePrivileges

SeQueryInformationToken

SeSinglePrivilegeCheck