IWEExtendWizard::CreateWizardPages メソッド (cluadmex.h)
[このメソッドは、[要件] セクションで指定したオペレーティング システムで使用できます。 このメソッドのサポートは、Windows Server 2008 で削除されました。]
ウィザード ページを作成し、 フェールオーバー クラスター管理者の 新しいリソース ウィザードまたはクラスター アプリケーション ウィザードに追加できます。
構文
HRESULT CreateWizardPages(
[in] IUnknown *piData,
[in] IWCWizardCallback *piCallback
);
パラメーター
[in] piData
追加するウィザード ページに関連する情報を取得するための IUnknown インターフェイス ポインター。 piData ポインターを使用して IUnknown::QueryInterface を呼び出すと、次のインターフェイスを使用できます。
ウィザード ページを作成する クラスター オブジェクト の種類に応じて、次のいずれかのインターフェイスへのポインターも使用できます。- プロパティ ページがノードに関連している場合は、IGetClusterNodeInfo。
- プロパティ ページがグループに関連する場合は、IGetClusterGroupInfo。
- プロパティ ページがネットワークに関連している場合は、IGetClusterNetworkInfo。
- プロパティ ページがネットワーク インターフェイスに関連している場合は、IGetClusterNetInterfaceInfo。
- プロパティ ページがリソースに関連している場合は、IGetClusterResourceInfo。
[in] piCallback
ウィザードに新しいプロパティ ページを追加するために使用される 、IMGWizardCallback インターフェイス実装へのポインター。
戻り値
操作の結果を説明する次のいずれかの値または HRESULT を返します。
| リターン コード/値 | Description |
|---|---|
|
操作に成功しました。 |
|
少なくとも 1 つのパラメーターが無効です。 |
|
この拡張機能では、グループの作成ウィザードまたはリソースの作成ウィザードへのプロパティ ページの追加はサポートされていません。 |
解説
Wizard97 ウィザード ページを追加するには、 IWEExtendWizard97::CreateWizard97Pages メソッドを使用します。
実装者へのメモ
追加するプロパティ ページごとに
- piData を使用して QueryInterface を呼び出し、新しいページに関連付けられているクラスター オブジェクトのインターフェイス ポインターを取得します。 たとえば、リソースのプロパティ ページを追加する場合は、 IGetClusterResourceInfo インターフェイスへのポインターを取得します。 拡張されているオブジェクトに関連しないデータを取得するインターフェイスに対してクエリを正常に実行することはできますが、メソッドを呼び出そうとしたときにエラーが発生することが予想されます。
-
ページを作成するには、 CreatePropertySheetPage 関数を呼び出します。 クラスター管理者によって提供されるページのようなページを生成するには、新しい各プロパティ ページの幅が 252 ダイアログ ユニットと 218 ダイアログ ユニットを超えてはなりません。また、次の 2 つの標準コントロールを含める必要があります。
- オブジェクト アイコンの場合、サイズが (18,20) の (8,7) に配置されたアイコン コントロール。
- オブジェクト名の場合、サイズが (247,10) の (38,12) に配置された静的コントロール。
- ページをクラスター管理者ウィザードに追加するには、piCallback ポインターを使用して、PIAWizardCallback::AddWizardPage を呼び出します。
要件
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows Server 2003 Enterprise、Windows Server 2003 Datacenter |
| 対象プラットフォーム | Windows |
| ヘッダー | cluadmex.h |