CPrivateObjectSecurityDesc::Create

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

呼び出し元のリソースマネージャによって作成されたプライベートオブジェクトの自己相対セキュリティ記述子を、割り当ておよび初期化します。

bool Create(
   const CSecurityDesc* pParent,
   const CSecurityDesc* pCreator,
   bool bIsDirectoryObject,
   const CAccessToken& Token,
   PGENERIC_MAPPING GenericMapping 
) throw( );
bool Create(
   const CSecurityDesc* pParent,
   const CSecurityDesc* pCreator,
   GUID* ObjectType,
   bool bIsContainerObject,
   ULONG AutoInheritFlags,
   const CAccessToken& Token,
   PGENERIC_MAPPING GenericMapping 
) throw( );

パラメータ

pParent
新しいオブジェクトが作成されている親ディレクトリを参照する CSecurityDesc オブジェクトへのポインタ。親ディレクトリがない場合は NULL に設定します。
pCreator
オブジェクトの作成者によって用意されたセキュリティ記述子へのポインタ。オブジェクトの作成者が新しいオブジェクトのセキュリティ情報を明示的に渡さない場合は、このパラメータを NULL に設定します。
bIsDirectoryObject
新しいオブジェクトにほかのオブジェクトを組み込むことができるかどうかを示す値。値 true は、新しいオブジェクトがコンテナであることを示します。値 false は、新しいオブジェクトがコンテナではないことを示します。
Token
オブジェクトを作成するクライアント処理のための CAccessToken オブジェクトへの参照。
GenericMapping
汎用的な権限とオブジェクトの特定の権限とのマップを指定する GENERIC_MAPPING 構造体へのポインタ。
ObjectType
現在のオブジェクトに関連付けられたオブジェクトの型を識別する GUID 構造体へのポインタ。オブジェクトに GUID がない場合は、ObjectType を NULL に設定します。
bIsContainerObject
新しいオブジェクトにほかのオブジェクトを組み込むことができるかどうかを示す値。値 true は、新しいオブジェクトがコンテナであることを示します。値 false は、新しいオブジェクトがコンテナではないことを示します。
AutoInheritFlags
pParent からのアクセス制御エントリ (ACE: Access Control Entry) の継承を制御する、一連のビットフラグ。詳細については、「CreatePrivateObjectSecurityEx」を参照してください。

戻り値

正常に終了した場合は true を返します。それ以外の場合は false を返します。

解説

このメソッドは、CreatePrivateObjectSercurity または CreatePrivateObjectSecurityEx を呼び出します。

新しいオブジェクトの型の GUID の指定または ACE の継承の制御を許可する 2 番目のメソッドは、Windows 2000 以降が稼動しているシステムだけで使用できます。

メモ :
自己相対セキュリティ記述子は、そのすべてのセキュリティ情報を連続するメモリブロックに格納するセキュリティ記述子です。