ACTRL_ACCESS_ENTRYA 構造体 (accctrl.h)

[アーティクル]
08/22/2023

指定されたトラスティのアクセス制御情報が含まれます。この構造体は、 ACE に格納されているアクセス制御情報と同等の情報を格納します。

構文

typedef struct _ACTRL_ACCESS_ENTRYA {
  TRUSTEE_A     Trustee;
  ULONG         fAccessFlags;
  ACCESS_RIGHTS Access;
  ACCESS_RIGHTS ProvSpecificAccess;
  INHERIT_FLAGS Inheritance;
  LPSTR         lpInheritProperty;
} ACTRL_ACCESS_ENTRYA, *PACTRL_ACCESS_ENTRYA;

メンバー

Trustee

アクセス制御エントリが適用されるユーザー、グループ、またはプログラム (サービスなど) を識別するトラスティ構造体。

fAccessFlags

Access メンバーと ProvSpecificAccess メンバーによって指定されたアクセス権がトラスティにどのように適用されるかを示します。このメンバーには、次のいずれかの値を指定できます。この構造体を IAccessControl の COM 実装で使用する場合、このメンバーはACTRL_ACCESS_ALLOWEDまたはACTRL_ACCESS_DENIEDである必要があります。

値	意味
ACTRL_ACCESS_ALLOWED 0x00000001	権限は許可されます。
ACTRL_ACCESS_DENIED 0x00000002	権限は拒否されます。
ACTRL_AUDIT_SUCCESS 0x00000004	権限の使用が失敗した場合、システムによって監査メッセージが生成されます。
ACTRL_AUDIT_FAILURE 0x00000008	権限の使用が正常に試行された場合は、監査メッセージが生成されます。

Access

エントリがトラスティに対して許可、拒否、または監査するアクセス権を指定するビットマスク。

このメンバーは、READ_CONTROLなどのアクセスフラグではなく、プロバイダーに依存しないアクセスフラグ (ACTRL_READ_CONTROL など) を使用する必要があります。オブジェクト型のプロバイダーは、これらのプロバイダーに依存しないフラグを、対応するプロバイダー固有のフラグに変換します。

この構造体を IAccessControl の COM 実装で使用する場合は、このメンバーをCOM_RIGHTS_EXECUTEする必要があります。

ACTRL_SYSTEM_ACCESS

ACTRL_DELETE

ACTRL_READ_CONTROL

ACTRL_CHANGE_ACCESS

ACTRL_CHANGE_OWNER

ACTRL_SYNCHRONIZE

ACTRL_STD_RIGHTS_ALL

ACTRL_STD_RIGHT_REQUIRED

COM_RIGHTS_EXECUTE

COM_RIGHTS_EXECUTE_LOCAL

COM_RIGHTS_EXECUTE_REMOTE

COM_RIGHTS_ACTIVATE_LOCAL

COM_RIGHTS_ACTIVATE_REMOTE

ProvSpecificAccess

プロバイダーの種類に固有のアクセス権を指定するビットマスク。 ACTRL_ACCESS_ENTRY構造体を使用する関数は、これらのビットを解釈せずにプロバイダーに渡します。ほとんどの場合、このメンバーは 0 である必要があります。

Inheritance

他のコンテナーまたはオブジェクトが、アクセスリストがアタッチされているプライマリオブジェクトからアクセス制御エントリを継承できるかどうかを決定するビットフラグのセット。この構造体を IAccessControl の COM 実装で使用する場合、この値はNO_INHERITANCEする必要があります。これは、アクセス制御エントリが継承できないことを示します。それ以外の場合は、この値をNO_INHERITANCEするか、次の値の組み合わせを使用できます。

値	意味
CONTAINER_INHERIT_ACE 0x2	プライマリオブジェクトに含まれるその他のコンテナーによって、エントリを継承します。
INHERIT_ONLY_ACE 0x8	ACE は ACL がアタッチされているプライマリオブジェクトには適用されませんが、プライマリオブジェクトに含まれるオブジェクトはエントリを継承します。
NO_PROPAGATE_INHERIT_ACE 0x4	OBJECT_INHERIT_ACEフラグとCONTAINER_INHERIT_ACE フラグは、継承されたエントリには反映されません。
OBJECT_INHERIT_ACE 0x1	プライマリオブジェクトに含まれる非コンテナーオブジェクトは、エントリを継承します。
SUB_CONTAINERS_AND_OBJECTS_INHERIT 0x3	プライマリオブジェクトに含まれるコンテナーオブジェクトと非コンテナーオブジェクトの両方がエントリを継承します。このフラグは、CONTAINER_INHERIT_ACEフラグとOBJECT_INHERIT_ACE フラグの組み合わせに対応します。
SUB_CONTAINERS_ONLY_INHERIT 0x2	プライマリオブジェクトに含まれるその他のコンテナーによって、エントリを継承します。このフラグは、CONTAINER_INHERIT_ACE フラグに対応します。
SUB_OBJECTS_ONLY_INHERIT 0x1	プライマリオブジェクトに含まれる非コンテナーオブジェクトは、エントリを継承します。このフラグは、OBJECT_INHERIT_ACE フラグに対応します。

lpInheritProperty

エントリを継承できるオブジェクト型を識別する null で終わる文字列へのポインター。この構造体を IAccessControl の COM 実装で使用する場合、このメンバーは NULL である必要があります。

注釈

注意

accctrl.h ヘッダーは、unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとしてACTRL_ACCESS_ENTRYを定義します。エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
Header	accctrl.h

こちらもご覧ください

ACTRL_ACCESS_ENTRY_LIST

トラスティ

次の方法で共有