SI_ACCESS 結構 (aclui.h)

SI_ACCESS 結構包含安全性物件訪問許可權或預設存取遮罩的相關信息。 ISecurityInformation：：GetAccessRights 方法會使用此結構來指定訪問控制編輯器用來初始化其屬性頁的資訊。

語法

typedef struct _SI_ACCESS {
  const GUID  *pguid;
  ACCESS_MASK mask;
  LPCWSTR     pszName;
  DWORD       dwFlags;
} SI_ACCESS, *PSI_ACCESS;

pguid

GUID 結構的指標，識別存取權或預設存取遮罩所套用的物件類型。 GUID 可以識別物件上的屬性集或屬性，或物件可包含的子物件類型。

如果這個成員指向GUID_NULL，則訪問許可權會套用至物件本身。

mask

位掩碼，指定這個結構所描述的存取權。遮罩可以包含標準與特定許可權的任何組合，但不應包含泛型許可權，例如GENERIC_ALL。

pszName

Null 終止 Unicode 字串的指標，其中包含描述訪問許可權的顯示字串。

或者， pszName 可以是 MAKEINTRESOURCE 宏所傳回的字串資源識別符。使用 ISecurityInformation：：GetObjectInformation 方法來識別包含字串資源的模組。

dwFlags

一組位旗標，指出顯示訪問許可權的位置。這個成員可以是下列各項的組合。

值	意義
SI_ACCESS_SPECIFIC	存取權會顯示在進階安全性頁面上。
SI_ACCESS_GENERAL	存取權會顯示在基本安全性頁面上。
SI_ACCESS_CONTAINER	指出僅適用於容器的存取權。如果設定此旗標，只有在 ISecurityInformation：：GetObjectInformation 方法指定SI_CONTAINER旗標時，存取權才會顯示在基本安全性頁面上。
SI_ACCESS_PROPERTY	表示屬性特定的訪問許可權。與SI_EDIT_PROPERTIES搭配使用。

這個成員也可以指定下列旗標的組合，以指出其他容器或物件是否可以繼承訪問許可權。

值	意義
CONTAINER_INHERIT_ACE	主要物件所包含的其他容器會繼承該項目。
INHERIT_ONLY_ACE	ACE 不適用於附加 ACL 的主要物件，但主要物件所包含的物件會繼承專案。
OBJECT_INHERIT_ACE	主要物件所包含的非container 物件會繼承專案。