共用方式為


ACCESS_ALLOWED_CALLBACK_OBJECT_ACE 結構 (winnt.h)

ACCESS_ALLOWED_CALLBACK_OBJECT_ACE 結構會定義訪問控制專案 (ACE) ,控制允許存取物件、屬性集或屬性。 ACE 包含一組訪問許可權、識別物件類型的 GUID,以及識別系統將授與存取權之信任的安全性標識碼 (SID) 。 ACE 也包含 GUID 和一組旗標,可控制子物件的 ACE 繼承。

呼叫 AuthzAccessCheck 函式時,透過 AuthzAccessCheck 函式指標傳遞之SECURITY_DESCRIPTOR結構的 DACL 中的每個ACCESS_ALLOWED_CALLBACK_OBJECT_ACE結構都會叫用呼叫應用程式定義的 AuthzAccessCheckCallback 函式,其中找到之ACCESS_ALLOWED_CALLBACK_OBJECT_ACE結構的指標會在 pAce 參數中傳遞。

語法

typedef struct _ACCESS_ALLOWED_CALLBACK_OBJECT_ACE {
  ACE_HEADER  Header;
  ACCESS_MASK Mask;
  DWORD       Flags;
  GUID        ObjectType;
  GUID        InheritedObjectType;
  DWORD       SidStart;
} ACCESS_ALLOWED_CALLBACK_OBJECT_ACE, *PACCESS_ALLOWED_CALLBACK_OBJECT_ACE;

成員

Header

ACE_HEADER 結構,指定 ACE 的大小和類型。 它也包含旗標,可控制子物件的 ACE 繼承。 ACE_HEADER 結構的 AceType 成員應該設定為 ACCESS_ALLOWED_CALLBACK_OBJECT_ACE_TYPE,而 AceSize 成員應該設定為配置給ACCESS_ALLOWED_CALLBACK_OBJECT_ACE結構的位元組總數。

Mask

ACCESS_MASK,指定系統將允許給信任者的訪問許可權。

Flags

一組位旗標,指出 ObjectTypeInheritedObjectType 成員是否存在。 此參數可以是下列一或多個值。

意義
0
ObjectTypeInheritedObjectType 都不存在。 SidStart 成員緊接在 Flags 成員之後。
ACE_OBJECT_TYPE_PRESENT
ObjectType 存在且包含 GUID

如果未指定此值, 則 InheritedObjectType 成員會緊接在 Flags 成員之後。

ACE_INHERITED_OBJECT_TYPE_PRESENT
InheritedObjectType 存在且包含 GUID

如果未指定此值,則所有類型的子物件都可以繼承 ACE。

ObjectType

只有在 Flags 成員中設定ACE_OBJECT_TYPE_PRESENT位時,才會存在這個成員。 否則, InheritedObjectType 成員會緊接在 Flags 成員之後。

如果這個成員存在,它是一種 GUID 結構,可識別屬性集、屬性、擴充許可權或子物件的類型。 此 GUID 的用途取決於 Mask 成員中指定的訪問許可權。

意義
ADS_RIGHT_DS_CONTROL_ACCESS
ObjectTypeGUID 可識別延伸訪問許可權。
ADS_RIGHT_DS_CREATE_CHILD
ObjectTypeGUID 會識別子對象的類型。 ACE 控制信任者建立此子物件類型的權利。
ADS_RIGHT_DS_READ_PROP
ObjectTypeGUID 會識別對象的屬性集或屬性。 ACE 控制信任者讀取屬性或屬性集的權利。
ADS_RIGHT_DS_WRITE_PROP
ObjectTypeGUID 會識別對象的屬性集或屬性。 ACE 控制信任者寫入屬性或屬性集的權利。
ADS_RIGHT_DS_SELF
ObjectTypeGUID 會識別已驗證的寫入。

InheritedObjectType

只有在 Flags 成員中設定ACE_INHERITED_OBJECT_TYPE_PRESENT位時,才會存在這個成員。

如果這個成員存在,它是 GUID 結構,可識別可繼承 ACE 的子物件類型。 繼承也會由 ACE_HEADER中的繼承旗標控制,以及針對子物件上所放置之繼承的任何保護。

此成員的位移可能會有所不同。 如果 Flags 成員不包含ACE_OBJECT_TYPE_PRESENT旗標, 則 InheritedObjectType 成員會從 ObjectType 成員指定的位移開始。

SidStart

信任者 SID 的第一個 DWORD 。 SID 的其餘位元組會儲存在 SidStart 成員之後的連續記憶體中。 此 SID 可以附加應用程式資料。

備註

如果未指定 ObjectTypeInheritedObjectTypeGUID則ACCESS_ALLOWED_CALLBACK_OBJECT_ACE 結構與 ACCESS_ALLOWED_CALLBACK_ACE 結構所使用的語意相同。 在此情況下,請使用 ACCESS_ALLOWED_CALLBACK_ACE 結構,因為它較小且更有效率。

包含 ACCESS_ALLOWED_CALLBACK_OBJECT_ACE 的 ACL 必須在其 ACL 標頭中指定ACL_REVISION_DS修訂編號。

Mask 成員所指定的訪問許可權會授與任何擁有已啟用之 SID 且符合 SidStart 成員中儲存之 SID 的信任

建立 ACCESS_ALLOWED_CALLBACK_OBJECT_ACE 結構時,必須配置足夠的記憶體,以容納 ObjectTypeInheritedObjectType 成員中的 GUID 結構,如果有其中一個或兩者存在,以及容納 SidStart 成員中信任項的完整 SID,以及後面連續的記憶體。

規格需求

需求
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
標頭 winnt.h (包括 Windows.h)

另請參閱

Ace

ACL

AddAuditAccessObjectAce

GUID

SID