IWEExtendPropertySheet::CreatePropertySheetPages メソッド (cluadmex.h)

クラスターオブジェクトのプロパティページを作成し、フェールオーバークラスター管理者プロパティシートに追加します。

構文

HRESULT CreatePropertySheetPages(
  [in] IUnknown                 *piData,
  [in] IWCPropertySheetCallback *piCallback
);

[in] piData

新しいプロパティページに関連する情報を取得するための IUnknown インターフェイスポインター。 piData ポインターを使用して IUnknown::QueryInterface メソッドを呼び出すと、次のインターフェイスを使用できます。

プロパティシートページを作成するクラスターオブジェクトの種類に応じて、次のいずれかのインターフェイスへのポインターも使用できます。

[in] piCallback

クラスター管理者プロパティシートにプロパティページを追加するための、IMGPropertySheetCallback インターフェイス実装へのポインター。

操作の結果を説明する次のいずれかの値または HRESULT を返します。

リターンコード/値	Description
NOERROR 0	操作に成功しました。
E_INVALIDARG 0x80070057	少なくとも 1 つのパラメーターが無効です。
E_NOTIMPL 0x80004001	拡張機能では、プロパティページの追加はサポートされていません。

フェールオーバークラスター管理者は、拡張機能の CreatePropertySheetPages メソッドを呼び出して、追加のクラスターオブジェクトを処理するプロパティシートを拡張します。

追加するプロパティページごとに

piData を使用して QueryInterface を呼び出し、ページに関連付けられているクラスターオブジェクトのインターフェイスポインターを取得します。たとえば、リソースのプロパティページを追加する場合は、 IGetClusterResourceInfo インターフェイスへのポインターを取得します。ターゲットオブジェクトに関連しないデータを取得するインターフェイスに対してクエリを正常に実行することはできますが、メソッドを呼び出そうとするとエラーが発生することが予想されます。
ページを作成するには、 CreatePropertySheetPage 関数を呼び出します。クラスター管理者によって提供されるページのようなページを生成するには、新しい各プロパティページの幅が 252 ダイアログユニットと 218 ダイアログユニットを超えてはなりません。また、次の 2 つの標準コントロールを含める必要があります。
- オブジェクトアイコンの場合、サイズが (18,20) の (8,7) に配置されたアイコンコントロール。
- オブジェクト名の場合、サイズが (206,10) の (38,12) に配置された静的コントロール。
ページをプロパティシートに追加するには、piCallback が指すWCSPPropertySheetCallback::AddPropertySheetPage メソッドを呼び出します。

要件	値
サポートされている最小のクライアント	サポートなし
サポートされている最小のサーバー	Windows Server 2008 Enterprise、Windows Server 2008 Datacenter
対象プラットフォーム	Windows
ヘッダー	cluadmex.h