ACE_HEADER構造体は、アクセス制御エントリ (ACE) の種類とサイズを記述します。
構文
typedef struct _ACE_HEADER {
UCHAR AceType;
UCHAR AceFlags;
USHORT AceSize;
} ACE_HEADER;
メンバーズ
AceType
ACE の種類。 このメンバーには、次のいずれかの値を指定できます。
| 価値 | 意味 |
|---|---|
| ACCESS_ALLOWED_ACE_TYPE | ACCESS_ALLOWED_ACE構造体を使用するアクセス許可 ACE。 |
| ACCESS_DENIED_ACE_TYPE | ACCESS_DENIED_ACE構造体を使用するアクセス拒否 ACE。 |
| SYSTEM_AUDIT_ACE_TYPE | SYSTEM_AUDIT_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 | Microsoft Windows 2000 以降: 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_ACE構造体は使用しないでください。
必要条件
| 要件 | 価値 |
|---|---|
| ヘッダー | ntifs.h (Ntifs.h を含む) |