ACE_HEADER 構造体 (winnt.h)

  • [アーティクル]

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
 システム アクセス制御リスト (SACL) のシステム監査 ACE と共に使用して、失敗したアクセス試行の監査メッセージを生成します。
INHERIT_ONLY_ACE
 継承専用 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
 非コンテナー子オブジェクトは、ACE を有効な ACE として継承します。

コンテナーである子オブジェクトの場合、NO_PROPAGATE_INHERIT_ACE ビット フラグも設定されていない限り、ACE は継承専用 ACE として継承されます。
SUCCESSFUL_ACCESS_ACE_FLAG
 SACL のシステム監査 ACE と共に使用して、アクセス試行が成功するための監査メッセージを生成します。

AceSize

ACE のサイズをバイト単位で指定します。

解説

ACE_HEADER構造体は、ACCESS_ALLOWED_ACEなど、さまざまな種類の ACE 構造体の最初のメンバーです。

システム アラーム ACE は現在サポートされていません。 AceType メンバーは、SYSTEM_ALARM_ACE_TYPEまたはSYSTEM_ALARM_OBJECT_ACE_TYPE値を指定できません。 SYSTEM_ALARM_ACEまたはSYSTEM_ALARM_OBJECT_ACE構造体は使用しないでください。

要件

   
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
Header winnt.h (Windows.h を含む)

関連項目

ACCESS_ALLOWED_ACE

ACCESS_ALLOWED_OBJECT_ACE

ACCESS_DENIED_ACE

ACCESS_DENIED_OBJECT_ACE

ACL

SYSTEM_AUDIT_ACE

SYSTEM_AUDIT_OBJECT_ACE