IGetClusterResourceInfo::GetResourceNetworkName メソッド (cluadmex.h)
[このメソッドは、[要件] セクションで指定したオペレーティング システムで使用できます。 このメソッドのサポートは、Windows Server 2008 で削除されました。]
リソースが依存するネットワーク名リソースによって管理されるネットワークの名前を返します。
構文
BOOL GetResourceNetworkName(
[in] LONG lObjIndex,
[out] BSTR lpszNetName,
[in, out] ULONG *pcchNetName
);
パラメーター
[in] lObjIndex
ターゲット リソースの 0 から始まるインデックスを表す数値。 ターゲット リソースは、ネットワーク名リソースに依存する場合と依存しない場合があります。 lObjIndex は、 IGetClusterDataInfo::GetObjectCount を呼び出すことによって取得できる数に制限されます。
[out] lpszNetName
lObjIndex によってインデックスが作成されたリソースが依存するネットワークの名前を含む、null で終わる Unicode 文字列へのポインター。 BSTR として宣言されていますが、このパラメーターは LPWSTR として実装されます。
[in, out] pcchNetName
lpszNetName が指すバッファーの最大文字数へのポインター。 入力時には、この値は 、MAX_COMPUTERNAME_LENGTH + 1 文字を含むのに十分な大きさにする必要があります。 出力時に、 pcchNetName はlpszNetName のコンテンツにコピーされた実際の文字数を指します。
戻り値
| リターン コード/値 | 説明 |
|---|---|
|
lObjIndex によってインデックスが作成されたリソースは、ネットワーク名リソースに依存しており、ネットワークの名前が正常に返されました。 |
|
lObjIndex によってインデックスが作成されたリソースは、ネットワーク名リソースに依存しません。 |
注釈
GetResourceNetworkName メソッドは、フェールオーバー クラスター管理者の拡張機能プロパティ ページで、リソースがネットワーク名リソースに対する既存の依存関係か保留中の依存関係かを判断するために必要です。
ネットワークの名前は、ネットワーク名リソースの Name プライベート プロパティに格納されます。 ネットワーク名リソースの Name 共通プロパティは、ネットワークではなくリソースの名前です。
MAX_COMPUTERNAME_LENGTH は、Windows ヘッダー ファイル WinBase.h で 15 として定義されている定数です。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows Server 2003 Enterprise、Windows Server 2003 Datacenter |
| 対象プラットフォーム | Windows |
| ヘッダー | cluadmex.h |