SePrivilegeCheck 函式 (ntifs.h)

發行項
02/26/2024

SePrivilegeCheck 例程會決定是否在主體的存取令牌中啟用一組指定的許可權。

語法

BOOLEAN SePrivilegeCheck(
  [in, out] PPRIVILEGE_SET            RequiredPrivileges,
  [in]      PSECURITY_SUBJECT_CONTEXT SubjectSecurityContext,
  [in]      KPROCESSOR_MODE           AccessMode
);

參數

[in, out] RequiredPrivileges

PRIVILEGE_SET 結構的指標。這個結構的 Privilege 成員是LUID_AND_ATTRIBUTES結構的數位。呼叫 SePrivilegeCheck 之前，請使用 Privilege 陣列來指出要檢查的許可權集。如果必須啟用所有許可權，請將控件成員設定為PRIVILEGE_SET_ALL_NECESSARY;或將它設定為零，如果它足以啟用任何一個許可權。

當 SePrivilegeCheck 傳回時，如果啟用對應的許可權，則每個LUID_AND_ATTRIBUTES結構的 Attributes 成員會設定為 SE_PRIVILEGE_USED_FOR_ACCESS。

[in] SubjectSecurityContext

主體所擷取安全性內容的指標。

[in] AccessMode

用於許可權檢查的存取模式。 UserMode 或 KernelMode。如果 AccessMode 設定為 KernelMode，則所有許可權都會標示為主體擁有， 而 SePrivilegeCheck 會傳回 TRUE。