ACE_HEADER 構造体 (winnt.h)
ACE_HEADER構造体は、アクセス制御エントリ (ACE) の種類とサイズを定義します。
構文
typedef struct _ACE_HEADER {
BYTE AceType;
BYTE AceFlags;
WORD AceSize;
} ACE_HEADER;
メンバー
AceType
ACE 型を指定します。 このメンバーには、次のいずれかの値を指定できます。
| 値 | 説明 |
|---|---|
|
ACCESS_ALLOWED_ACE構造体を使用するアクセス許可 ACE。 |
|
ACCESS_ALLOWED_CALLBACK_ACE構造体を使用するアクセス許可コールバック ACE。 |
|
ACCESS_ALLOWED_CALLBACK_OBJECT_ACE構造体を使用するオブジェクト固有のアクセス許可コールバック ACE。 |
|
予約済み。 |
|
ACCESS_ALLOWED_OBJECT_ACE構造体を使用するオブジェクト固有のアクセス許可 ACE。 |
|
ACCESS_DENIED_ACE構造体を使用するアクセス拒否 ACE。 |
|
ACCESS_DENIED_CALLBACK_ACE構造体を使用するアクセス拒否コールバック ACE。 |
|
ACCESS_DENIED_CALLBACK_OBJECT_ACE構造体を使用するオブジェクト固有のアクセス拒否コールバック ACE。 |
|
ACCESS_DENIED_OBJECT_ACE構造体を使用するオブジェクト固有のアクセス拒否 ACE。 |
|
SYSTEM_ALARM_OBJECT_ACE_TYPEと同じです。 |
|
SYSTEM_ALARM_ACE_TYPEと同じです。 |
|
予約済み。 |
|
SYSTEM_ALARM_OBJECT_ACE_TYPEと同じです。 |
|
SYSTEM_ALARM_OBJECT_ACE_TYPEと同じです。 |
|
ACCESS_ALLOWED_ACE_TYPEと同じです。 |
|
ACCESS_ALLOWED_OBJECT_ACE_TYPEと同じです。 |
|
将来利用するために予約されています。 SYSTEM_ALARM_ACE構造を使用するシステム アラーム ACE。 |
|
将来利用するために予約されています。 SYSTEM_ALARM_CALLBACK_ACE構造体を使用するシステム アラーム コールバック ACE。 |
|
将来利用するために予約されています。 SYSTEM_ALARM_CALLBACK_OBJECT_ACE構造体を使用するオブジェクト固有のシステム アラーム コールバック ACE。 |
|
将来利用するために予約されています。 SYSTEM_ALARM_OBJECT_ACE構造体を使用するオブジェクト固有のシステム アラーム ACE。 |
|
SYSTEM_AUDIT_ACE構造体を使用するシステム監査 ACE。 |
|
SYSTEM_AUDIT_CALLBACK_ACE構造体を使用するシステム監査コールバック ACE。 |
|
SYSTEM_AUDIT_CALLBACK_OBJECT_ACE構造体を使用するオブジェクト固有のシステム監査コールバック ACE。 |
|
SYSTEM_AUDIT_OBJECT_ACE構造体を使用するオブジェクト固有のシステム監査 ACE。 |
|
SYSTEM_MANDATORY_LABEL_ACE構造体を使用する必須ラベル ACE。 |
AceFlags
ACE 型固有のコントロール フラグのセットを指定します。 このメンバーには、次の値の組み合わせを指定できます。
| 値 | 説明 |
|---|---|
|
コンテナーである子オブジェクト (ディレクトリなど) は、ACE を有効な ACE として継承します。 NO_PROPAGATE_INHERIT_ACE ビット フラグも設定されていない限り、継承された ACE は継承可能です。 |
|
システム アクセス制御リスト (SACL) のシステム監査 ACE と共に使用して、失敗したアクセス試行の監査メッセージを生成します。 |
|
継承専用 ACE を示します。これは、アタッチ先のオブジェクトへのアクセスを制御しません。 このフラグが設定されていない場合、ACE は、アタッチ先のオブジェクトへのアクセスを制御する有効な ACE です。
他の継承フラグの状態に応じて、有効な ACE と継承専用の ACE の両方を継承できます。 |
|
ACE が継承されたことを示します。 システムは、継承された ACE を子オブジェクトに伝達するときに、このビットを設定します。 |
|
ACE が子オブジェクトによって継承されている場合、システムは継承された ACE のOBJECT_INHERIT_ACEフラグとCONTAINER_INHERIT_ACEフラグをクリアします。 これにより、ACE が後続の世代のオブジェクトによって継承されなくなります。 |
|
非コンテナー子オブジェクトは、ACE を有効な ACE として継承します。
コンテナーである子オブジェクトの場合、NO_PROPAGATE_INHERIT_ACE ビット フラグも設定されていない限り、ACE は継承専用 ACE として継承されます。 |
|
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 を含む) |