ISecurityInformation：：GetAccessRights 方法 (aclui.h)

發行項
03/05/2024

GetAccessRights 方法會要求可控制安全性對象訪問許可權的相關信息。訪問控制編輯器會呼叫這個方法，以擷取用來初始化屬性頁的顯示字串和其他資訊。如需詳細資訊，請參閱訪問許可權和存取遮罩。

語法

HRESULT GetAccessRights(
  [in]  const GUID *pguidObjectType,
  [in]  DWORD      dwFlags,
  [out] PSI_ACCESS *ppAccess,
  [out] ULONG      *pcAccesses,
  [out] ULONG      *piDefaultAccess
);

參數

[in] pguidObjectType

GUID 結構的指標，識別要求訪問許可權的物件類型。如果此參數為 NULL 或GUID_NULL指標，則傳回所編輯對象的訪問許可權。否則，GUID 會識別 ISecurityInformation：：GetInheritTypes 方法傳回的子物件類型。 GUID 會對應至物件特定 ACE 的 InheritedObjectType 成員。

[in] dwFlags

一組位旗標，表示要初始化的屬性頁。如果基本安全性頁面正在初始化，這個值就會是零。否則，它是下列值的組合。

值	意義
SI_ADVANCED	正在初始化 Advanced Security 屬性表。
SI_EDIT_AUDITS	[ 進階安全性] 屬性表包含 [稽核 ] 屬性頁。
SI_EDIT_PROPERTIES	Advanced Security 屬性表可讓您編輯套用至物件之屬性和屬性集的 ACE。

[out] ppAccess

SI_ACCESS 結構的陣列指標。數位必須針對每個存取權包含一個專案。您可以指定套用至物件本身的訪問許可權，以及僅適用於物件上屬性集或屬性的物件特定訪問許可權。

[out] pcAccesses

ULONG 的指標，指出 ppAccess 陣列中的項目數目。

[out] piDefaultAccess

ULONG 的指標，表示包含預設訪問許可權之陣列專案之以零起始的索引。訪問控制編輯器會使用此專案作為新 ACE 的初始存取許可權。

傳回值

如果函式成功，函式會傳回S_OK。

如果函式失敗，它會傳回 HRESULT 值，指出錯誤。如需常見錯誤碼的清單，請參閱一般 HRESULT 值。

備註

每次初始化屬性頁時，都會呼叫 GetAccessRights 方法。

訪問控制編輯器不會釋放 ppAccess 中傳回的指標。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	aclui.h