OBJECTS_AND_NAME_W 構造体 (accctrl.h)

[アーティクル]
02/26/2024

OBJECTS_AND_NAME構造体には、名前でトラスティを識別する文字列と、オブジェクト固有のアクセス制御エントリ (ACE) のオブジェクトの種類を識別する追加の文字列が含まれています。

構文

typedef struct _OBJECTS_AND_NAME_W {
  DWORD          ObjectsPresent;
  SE_OBJECT_TYPE ObjectType;
  LPWSTR         ObjectTypeName;
  LPWSTR         InheritedObjectTypeName;
  LPWSTR         ptstrName;
} OBJECTS_AND_NAME_W, *POBJECTS_AND_NAME_W;

メンバー

ObjectsPresent

ObjectTypeName メンバーと InheritedObjectTypeName メンバーに文字列が含まれているかどうかを示します。このパラメーターは、次の値と組み合わせて使用できます。

値	意味
ACE_OBJECT_TYPE_PRESENT 0x1	ObjectTypeName メンバーには文字列が含まれています。
ACE_INHERITED_OBJECT_TYPE_PRESENT 0x2	InheritedObjectTypeName メンバーには文字列が含まれています。

ObjectType

オブジェクトの型を示す SE_OBJECT_TYPE 列挙の値を指定します。

ObjectTypeName

ACE が適用されるオブジェクトの種類を識別する null で終わる文字列へのポインター。

この文字列は、Active Directory スキーマの有効な LDAP 表示名である必要があります。

InheritedObjectTypeName

ACE を継承できるオブジェクトの型を識別する null で終わる文字列へのポインター。

この文字列は、Active Directory スキーマの有効な LDAP 表示名である必要があります。

ACE_INHERITED_OBJECT_TYPE_PRESENT ビットが ObjectsPresent メンバーに設定されていない場合、 InheritedObjectTypeName メンバーは無視され、すべての種類の子オブジェクトは ACE を継承できます。それ以外の場合は、指定したオブジェクト型のみが ACE を継承できます。どちらの場合も、継承は、 ACE_HEADER 構造体の継承フラグと、子オブジェクトに配置された継承に対する保護によっても制御されます。

ptstrName

トラスティの名前を含む null で終わる文字列へのポインター。

注釈

トラスティ構造体の ptstrName メンバーには、OBJECTS_AND_NAME構造体へのポインターを指定できます。これにより、SetEntriesInAcl や GetExplicitEntriesFromAcl などの関数は、オブジェクト固有の ACE 情報を、EXPLICIT_ACCESS構造体のトラスティ メンバーに格納できます。

注意

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

要件

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