DSCreateSecurityPage 関数 (dssec.h)

DSCreateSecurityPage 関数は、Active Directory オブジェクトのセキュリティ プロパティ ページを作成します。 結果のプロパティ ページは、プロパティ シートに追加できます。

構文

HRESULT DSCreateSecurityPage(
  [in]           LPCWSTR                pwszObjectPath,
  [in, optional] LPCWSTR                pwszObjectClass,
  [in]           DWORD                  dwFlags,
  [out]          HPROPSHEETPAGE         *phPage,
  [in, optional] PFNREADOBJECTSECURITY  pfnReadSD,
  [in, optional] PFNWRITEOBJECTSECURITY pfnWriteSD,
  [in]           LPARAM                 lpContext
);

パラメーター

[in] pwszObjectPath

オブジェクトの完全な Active Directory パスを表す null で終わるワイド文字列へのポインター。

[in, optional] pwszObjectClass

オブジェクト クラスを表す null で終わるワイド文字列へのポインター。 この値は NULL にすることができます。

[in] dwFlags

セキュリティ プロパティ ページに使用されるフラグ。 このパラメーターには、none または次のフラグの任意の組み合わせを指定できます。

[out] phPage

作成されたセキュリティ プロパティ ページを返す HPROPSHEETPAGE へのポインター。

[in, optional] pfnReadSD

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

[in, optional] pfnWriteSD

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

[in] lpContext

pfnReadSD または pfnWriteSD によって識別される関数に渡すコンテキスト。

戻り値

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

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

解説

pfnReadSD によって指される関数は、次のように定義されます。

#include <windows.h>

typedef HRESULT (WINAPI *PFNREADOBJECTSECURITY)(
    LPCWSTR,               // Active Directory path of object
    SECURITY_INFORMATION,  // the security information to read
    PSECURITY_DESCRIPTOR*, // the returned security descriptor 
    LPARAM                 // context parameter
);

DSCreateSecurityPage 関数は、LocalFree 関数の呼び出しによって、上記の 3 番目のパラメーターで返されるセキュリティ記述子を解放します。

pfnWriteSD によって指される関数は、次のように定義されます。

#include <windows.h>

typedef HRESULT (WINAPI *PFNWRITEOBJECTSECURITY)(
    LPCWSTR,              // Active Directory path of object
    SECURITY_INFORMATION, // the security information to write
    PSECURITY_DESCRIPTOR, // the security descriptor to write
    LPARAM                // context parameter
);

要件

関連項目

[基本的なセキュリティ] プロパティ ページ

ISecurityInformation