共用方式為

winnt.h) (SYSTEM_ALARM_CALLBACK_OBJECT_ACE 結構

  • 發行項

不支援。

SYSTEM_ALARM_CALLBACK_OBJECT_ACE結構會保留供日後使用。

語法

typedef struct _SYSTEM_ALARM_CALLBACK_OBJECT_ACE {
  ACE_HEADER  Header;
  ACCESS_MASK Mask;
  DWORD       Flags;
  GUID        ObjectType;
  GUID        InheritedObjectType;
  DWORD       SidStart;
} SYSTEM_ALARM_CALLBACK_OBJECT_ACE, *PSYSTEM_ALARM_CALLBACK_OBJECT_ACE;

成員

Header

ACE_HEADER 結構，指定 ACE 的大小和類型。 它包含旗標，可控制子物件的 ACE 繼承。 結構也包含旗標，指出 ACE 會稽核成功的存取嘗試、失敗的存取嘗試，或兩者。 ACE_HEADER 結構的 AceType 成員應該設定為 SYSTEM_ALARM_CALLBACK_OBJECT_ACE_TYPE。

Mask

ACCESS_MASK，指定系統將會稽核信任者對存取嘗試的存取權。

Flags

一組位旗標，指出 ObjectType 和 InheritedObjectType 成員是否包含 GUID。 此參數可以是下列值的組合。 將所有未定義的位設定為零。

值 意義
ACE_OBJECT_TYPE_PRESENT
 ObjectType 成員包含 GUID。
ACE_INHERITED_OBJECT_TYPE_PRESENT
 InheritedObjectType 成員包含 GUID。

ObjectType

識別屬性集、屬性、擴充許可權或子物件類型的 GUID 結構。

只有在 Flags 成員中設定ACE_OBJECT_TYPE_PRESENT位時，這個成員才有效。 否則會忽略 ObjectType 。

此 GUID 的用途取決於 Mask 成員中指定的訪問許可權。

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

InheritedObjectType

GUID 結構，識別可繼承 ACE 的子物件類型。

只有在 Flags 成員中設定ACE_INHERITED_OBJECT_TYPE_PRESENT位時，這個成員才有效。 如果未設定該位，則會忽略 InheritedObjectType ，而且所有類型的子物件都可以繼承 ACE。 不論是哪一種情況，繼承也是由 ACE_HEADER中的繼承旗標所控制，以及對子物件上所放置之繼承的任何保護。

SidStart

信任項 ACE 的第一個 DWORD 。 此 ACE 可以附加應用程式資料。 呼叫 AuthzAccessCheckCallback 函式時，此 ACE 會當做該函式的 pAce 參數傳遞。

備註

如果未指定 ObjectType 或 InheritedObjectType GUID， 則SYSTEM_ALARM_CALLBACK_OBJECT_ACE 結構具有與 SYSTEM_ALARM_CALLBACK_ACE 結構相同的語意。 在此情況下，請使用 SYSTEM_ALARM_CALLBACK_ACE 結構，因為它較小且更有效率。

包含 SYSTEM_ALARM_CALLBACK_OBJECT_ACE 的 ACL 必須在其 ACE_HEADER 結構中指定ACL_REVISION_DS修訂編號。

規格需求

需求 值
標頭 winnt.h