winnt.h) (ACE_HEADER結構

發行項
08/27/2023

ACE_HEADER結構會定義ACE) (存取控制專案的類型和大小。

語法

typedef struct _ACE_HEADER {
  BYTE AceType;
  BYTE AceFlags;
  WORD AceSize;
} ACE_HEADER;

成員

AceType

指定 ACE 類型。這個成員可以是下列其中一個值。

值	意義
ACCESS_ALLOWED_ACE_TYPE	使用 ACCESS_ALLOWED_ACE 結構的存取允許 ACE。
ACCESS_ALLOWED_CALLBACK_ACE_TYPE	使用 ACCESS_ALLOWED_CALLBACK_ACE 結構的存取允許回呼 ACE。
ACCESS_ALLOWED_CALLBACK_OBJECT_ACE_TYPE	使用 ACCESS_ALLOWED_CALLBACK_OBJECT_ACE 結構的物件特定存取允許回呼 ACE。
ACCESS_ALLOWED_COMPOUND_ACE_TYPE	保留的。
ACCESS_ALLOWED_OBJECT_ACE_TYPE	使用 ACCESS_ALLOWED_OBJECT_ACE 結構的物件特定存取允許 ACE。
ACCESS_DENIED_ACE_TYPE	使用 ACCESS_DENIED_ACE 結構的拒絕存取 ACE。
ACCESS_DENIED_CALLBACK_ACE_TYPE	使用 ACCESS_DENIED_CALLBACK_ACE 結構的拒絕存取回呼 ACE。
ACCESS_DENIED_CALLBACK_OBJECT_ACE_TYPE	使用 ACCESS_DENIED_CALLBACK_OBJECT_ACE 結構的物件特定拒絕存取回呼 ACE。
ACCESS_DENIED_OBJECT_ACE_TYPE	使用 ACCESS_DENIED_OBJECT_ACE 結構的物件特定存取拒絕 ACE。
ACCESS_MAX_MS_ACE_TYPE	與SYSTEM_ALARM_OBJECT_ACE_TYPE相同。
ACCESS_MAX_MS_V2_ACE_TYPE	與SYSTEM_ALARM_ACE_TYPE相同。
ACCESS_MAX_MS_V3_ACE_TYPE	保留的。
ACCESS_MAX_MS_V4_ACE_TYPE	與SYSTEM_ALARM_OBJECT_ACE_TYPE相同。
ACCESS_MAX_MS_OBJECT_ACE_TYPE	與SYSTEM_ALARM_OBJECT_ACE_TYPE相同。
ACCESS_MIN_MS_ACE_TYPE	與ACCESS_ALLOWED_ACE_TYPE相同。
ACCESS_MIN_MS_OBJECT_ACE_TYPE	與ACCESS_ALLOWED_OBJECT_ACE_TYPE相同。
SYSTEM_ALARM_ACE_TYPE	保留供未來使用。使用 SYSTEM_ALARM_ACE 結構的系統警示 ACE。
SYSTEM_ALARM_CALLBACK_ACE_TYPE	保留供未來使用。使用 SYSTEM_ALARM_CALLBACK_ACE 結構的系統警示回呼 ACE。
SYSTEM_ALARM_CALLBACK_OBJECT_ACE_TYPE	保留供未來使用。使用 SYSTEM_ALARM_CALLBACK_OBJECT_ACE 結構的物件特定系統警示回呼 ACE。
SYSTEM_ALARM_OBJECT_ACE_TYPE	保留供未來使用。使用 SYSTEM_ALARM_OBJECT_ACE 結構的物件特定系統警示 ACE。
SYSTEM_AUDIT_ACE_TYPE	使用 SYSTEM_AUDIT_ACE 結構的系統稽核 ACE。
SYSTEM_AUDIT_CALLBACK_ACE_TYPE	使用 SYSTEM_AUDIT_CALLBACK_ACE 結構的系統稽核回呼 ACE。
SYSTEM_AUDIT_CALLBACK_OBJECT_ACE_TYPE	使用 SYSTEM_AUDIT_CALLBACK_OBJECT_ACE 結構的物件特定系統稽核回呼 ACE。
SYSTEM_AUDIT_OBJECT_ACE_TYPE	使用 SYSTEM_AUDIT_OBJECT_ACE 結構的物件特定系統稽核 ACE。
SYSTEM_MANDATORY_LABEL_ACE_TYPE 0x11	使用 SYSTEM_MANDATORY_LABEL_ACE 結構的必要標籤 ACE。

AceFlags

指定一組 ACE 類型特定的控制項旗標。這個成員可以是下列值的組合。

值	意義
CONTAINER_INHERIT_ACE	屬於容器的子物件，例如目錄，會繼承 ACE 作為有效的 ACE。除非同時設定NO_PROPAGATE_INHERIT_ACE位旗標，否則繼承的 ACE 是可繼承的。
FAILED_ACCESS_ACE_FLAG	與系統存取控制清單中的系統稽核 ACE 搭配使用， (SACL) ，以針對失敗的存取嘗試產生稽核訊息。
INHERIT_ONLY_ACE	表示繼承的 ACE，其不會控制其附加物件的存取權。如果未設定此旗標，則 ACE 是有效的 ACE，可控制其所附加物件的存取權。視其他繼承旗標的狀態而定，可以繼承有效和僅繼承 ACE。
INHERITED_ACE	表示已繼承 ACE。當系統將繼承的 ACE 傳播至子物件時，系統會設定這個位。
NO_PROPAGATE_INHERIT_ACE	如果 ACE 是由子物件繼承，系統會清除繼承之 ACE 中的OBJECT_INHERIT_ACE和CONTAINER_INHERIT_ACE旗標。這可防止後續的物件層代繼承 ACE。
OBJECT_INHERIT_ACE	Noncontainer 子物件會繼承 ACE 作為有效的 ACE。如果是容器的子物件，除非同時設定NO_PROPAGATE_INHERIT_ACE位旗標，否則 ACE 會繼承為僅限繼承的 ACE。
SUCCESSFUL_ACCESS_ACE_FLAG	與 SACL 中的系統稽核 ACE 搭配使用，以產生成功存取嘗試的稽核訊息。

AceSize

指定 ACE 的大小，以位元組為單位。

備註

ACE_HEADER結構是各種 ACE 結構類型的第一個成員，例如ACCESS_ALLOWED_ACE。

目前不支援系統警示 ACE。 AceType成員無法指定SYSTEM_ALARM_ACE_TYPE或SYSTEM_ALARM_OBJECT_ACE_TYPE值。請勿使用 SYSTEM_ALARM_ACE 或 SYSTEM_ALARM_OBJECT_ACE 結構。

規格需求


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