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 または次のフラグの任意の組み合わせを指定できます。

値 意味
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] 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
);

要件

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

関連項目

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

ISecurityInformation