DSCreateISecurityInfoObjectEx 関数 (dssec.h)

  • [アーティクル]

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

構文

HRESULT DSCreateISecurityInfoObjectEx(
  [in]           LPCWSTR                pwszObjectPath,
  [in]           LPCWSTR                pwszObjectClass,
  [in]           LPCWSTR                pwszServer,
  [in]           LPCWSTR                pwszUserName,
  [in]           LPCWSTR                pwszPassword,
  [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] pwszServer

pwszObjectPath パラメーターで指定されたオブジェクトのサーバー。 このパラメーターの値が NULL の場合、 サーバーは pwszObjectPath パラメーターで指定されたパスから取得されます。

[in] pwszUserName

新しい ISecurityInformation オブジェクトに関連付けるユーザー名。 このパラメーターの値が NULL の場合は、 Active Directory サービス インターフェイス (ADSI) の既定値が使用されます。

[in] pwszPassword

新しい ISecurityInformation オブジェクトに関連付けるパスワード。 このパラメーターの値が NULL の場合は、 Active Directory サービス インターフェイス (ADSI) の既定値が使用されます。

[in] dwFlags

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

値 意味
DSSI_READ_ONLY
0x00000001
 セキュリティ プロパティは読み取り専用です。
DSSI_NO_ACCESS_CHECK
0x00000002
 アクセスチェックは実行されません。
DSSI_NO_EDIT_SACL
0x00000004
 システム アクセス制御リスト (SACL) プロパティは読み取り専用です。
DSSI_NO_EDIT_OWNER
0x00000008
 オブジェクト所有者プロパティは読み取り専用です。
DSSI_IS_ROOT
0x00000010
 オブジェクトはルート オブジェクトです。
DSSI_NO_FILTER
0x00000020
 フィルターは適用しないでください。
DSSI_NO_READONLY_MESSAGE
0x00000040
 読み取り専用ポップアップ メッセージを抑制します。

[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 値」を参照してください。

要件

   
サポートされている最小のクライアント サポートなし
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー dssec.h
Library DSSec.lib
[DLL] DSSec.dll