DSCreateISecurityInfoObject 関数 (dssec.h)

DSCreateISecurityInfoObject 関数は、指定されたディレクトリ サービス (DS) オブジェクトに関連付けられた ISecurityInformation インターフェイスのインスタンスを作成します。

構文

HRESULT DSCreateISecurityInfoObject(
  [in]           LPCWSTR                pwszObjectPath,
  [in]           LPCWSTR                pwszObjectClass,
  [in]           DWORD                  dwFlags,
  [out]          LPSECURITYINFO         *ppSI,
  [in, optional] PFNREADOBJECTSECURITY  pfnReadSD,
  [in, optional] PFNWRITEOBJECTSECURITY pfnWriteSD,
  [in]           LPARAM                 lpContext
);

パラメーター

[in] pwszObjectPath

ISecurityInformation インターフェイスのインスタンスを作成する DS オブジェクトの完全パス。

[in] pwszObjectClass

pwszObjectPath パラメーターで指定されたオブジェクトのクラス。

[in] dwFlags

ISecurityInformation インターフェイスの新しいインスタンスに関連付けられているセキュリティ プロパティ ページに使用されるフラグ。 このパラメーターには、次のフラグの任意の組み合わせを指定できます。

[out] ppSI

この関数によって作成される ISecurityInformation インターフェイスのインスタンスへのポインター。

[in, optional] pfnReadSD

オブジェクトの セキュリティ記述子 を読み取るために使用される関数へのポインター。 この値は NULL にすることができます。 pfnReadSD が NULL でない場合、DSCreateISecurityInfoObject はpfnReadSD によって参照される関数を呼び出して、オブジェクトのセキュリティ記述子を取得します。

[in, optional] pfnWriteSD

オブジェクトのセキュリティ記述子を記述するために使用される関数へのポインター。 この値は NULL にすることができます。 pfnWriteSD が NULL でない場合、DSCreateISecurityInfoObject はpfnWriteSD によって参照される関数を呼び出して、オブジェクトのセキュリティ記述子を書き込みます。

[in] lpContext

pfnReadSD パラメーターと pfnWriteSD パラメーターによって識別される関数に渡すコンテキスト。

戻り値

関数が成功した場合、関数はS_OKを返します。

関数が失敗した場合は、エラーを示す HRESULT 値を返します。 一般的なエラー コードの一覧については、「 共通の HRESULT 値」を参照してください。

要件