Win32 API 日本語リファレンス
ホーム › Networking.Clustering › IGetClusterUIInfo

IGetClusterUIInfo

COM
📘 Microsoft Learn (日本語) · English
IID97dede50-fc6b-11cf-b5f5-00a0c90ab505継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

フェールオーバー クラスター アドミニストレーターのユーザー インターフェイスに関する情報を取得するために、フェールオーバー クラスター アドミニストレーターの拡張機能から呼び出されます。

解説(Remarks)

IGetClusterUIInfo インターフェイスは、 フェールオーバー クラスター アドミニストレーターが次のメソッドの実装を呼び出すときに使用できます。

フェールオーバー クラスター アドミニストレーターは、IUnknown インターフェイス ポインター piData を渡します。piData を使用して QueryInterface を呼び出し、 IGetClusterUIInfo のメソッドを取得してください。

IGetClusterGroupInfo などの他の情報インターフェイスを、 IGetClusterUIInfo インターフェイスから取得しないでください。 QueryInterface は有効なインターフェイスを返しますが、 この操作はクラスターのコンテキストでは有効ではなく、結果として実在しないクラスター オブジェクトを表すインターフェイスが得られます。 例については、 IGetClusterResourceInfo を参照してください。

メソッド 4

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT GetClusterName(LPWSTR lpszName, INT* pcchName)

クラスターの名前を返します。(IGetClusterUIInfo.GetClusterName)

lpszNameLPWSTRoutクラスターの名前を格納する null 終端の Unicode 文字列へのポインター。呼び出し元が名前の長さのみを要求する場合は NULL を指定します。BSTR として宣言されていますが、このパラメーターは LPWSTR として実装されています。
pcchNameINT*inout入力時は、lpszName パラメーターが指すバッファー内の文字数へのポインター。 出力時は、NULL 終端文字を含むバッファー内の総文字数へのポインター。

戻り値

GetClusterName が成功しなかった場合、他の HRESULT 値を返すことがあります。

戻り値/値 説明
NOERROR
0
 操作は成功しました。
E_INVALIDARG
0x80070057
 1 つ以上のパラメーターが無効です。
HRESULT_FROM_WIN32(ERROR_MORE_DATA)
0x800700ea
 lpszName が指すバッファーが小さすぎて、要求された名前を格納できません。 GetClusterName は、 必要な文字数を pcchName の内容として返します。

解説(Remarks)

lpszName パラメーターが NULL に設定され、 pcchName パラメーターが NULL でない場合、 GetClusterName メソッドは NOERROR を返します。

vtbl 4 DWORD GetLocale()

プロパティ ページおよびウィザード ページで使用するロケール識別子を返します。

戻り値

GetLocale は常にクラスターのロケール識別子を返します。

解説(Remarks)

フェールオーバー クラスター アドミニストレーターの拡張機能は、 ダイアログ リソースの読み込みに使用できるロケール識別子を取得するために GetLocale メソッドを呼び出します。単一のフェールオーバー クラスター アドミニストレーター拡張 DLL で 複数の言語をサポートできます。

vtbl 5 HFONT GetFont()

プロパティ ページおよびウィザード ページに表示するフォントのハンドルを返します。

戻り値

GetFont が成功した場合、フォント ハンドルを返します。

解説(Remarks)

GetFont メソッドはフォント ハンドルとして NULL を返します。 フェールオーバー クラスター アドミニストレーターの拡張機能は、 この戻り値をユーザー インターフェイスの表示に使用しないでください。

vtbl 6 HICON GetIcon()

プロパティ ページおよびウィザード ページの左上隅で使用するアイコンのハンドルを返します。

戻り値

GetIcon は常にアイコンのハンドルを返します。

解説(Remarks)

GetIcon メソッドを使用する場合、各プロパティ ページまたはウィザード ページには、 位置 (8,7)、サイズ (18,20) のアイコン コントロールを配置する必要があります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数: 
#define global IID_IGetClusterUIInfo "{97DEDE50-FC6B-11CF-B5F5-00A0C90AB505}"
#usecom global IGetClusterUIInfo IID_IGetClusterUIInfo "{}"
#comfunc global IGetClusterUIInfo_GetClusterName  3 var,var
#comfunc global IGetClusterUIInfo_GetLocale       4
#comfunc global IGetClusterUIInfo_GetFont         5
#comfunc global IGetClusterUIInfo_GetIcon         6
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。