IGetClusterResourceInfo

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

拡張対象のオブジェクトがリソースでない場合、 IGetClusterResourceInfo のメソッドに対するクエリは失敗します。 それ以外の場合は、フェールオーバー クラスター アドミニストレーターが次のメソッドの実装を呼び出す際に、 IGetClusterResourceInfo インターフェイスを使用できます。

• IWEExtendPropertySheet::CreatePropertySheetPages
• IWEExtendContextMenu::AddContextMenuItems
• IWEExtendWizard::CreateWizardPages
• IWEExtendWizard97::CreateWizard97Pages
• IWEInvokeCommand::InvokeCommand

IGetClusterResourceInfo インターフェイスは、リソース拡張のコンテキストでのみ使用してください。 IGetClusterGroupInfo などの他の情報インターフェイスを、 IGetClusterResourceInfo インターフェイスから取得しないでください。 QueryInterface は有効なインターフェイスを返しますが、 その操作はクラスターのコンテキストでは有効ではなく、 結果として実在するクラスター オブジェクトを表さないインターフェイスが得られます。

例

次のコードのうち、C スタイルのコメントで囲まれた部分は、前述の理由により失敗します。

//
// Context is a resource extension.
//
HRESULT CExtObject::HrGetResourceInfo( IGetClusterResourceInfo *piResInfo )
 {
  HRESULT   hr;
  HRESOURCE hRes;
  HGROUP    hGroup;
  HCLUSTER  hCluster;
  DWORD     cchNameSize = MAX_NAME_SIZE; // 256
  WCHAR     szGroupName[cchNameSize];

  IGetClusterGroupInfo *pGrpInfo;

  hRes = piResInfo->GetResourceHandle();

  //
  // Get group handle
  //
/*******************************************************************
// Incorrect:

  //
  // Obtain an IGetClusterGroupInfo interface from 
  // IGetClusterResourceInfo. By the rules of QueryInterface, this 
  // must return a valid interface. But it is not a valid cluster 
  // operation so the interface won't represent a real object.
  //
  hr = pResInfo->QueryInterface( IID_IGetClusterGroupInfo, 
                                 (LPVOID *) &pGrpInfo );

  //
  // Interface is valid, will pass this test.
  //
  if( FAILED( hr ) )
    goto Error;

  //
  // FAILS!
  // Interface does not represent a real cluster object.
  //    
  hGrp = pGrpInfo->GetGroupHandle( 0 );

*******************************************************************/
// Correct:    
  //
  // Use the valid resource handle to call GetClusterResourceState.
  // This yields the name of the group to which it belongs, which
  // can be used to obtain a group handle.
  //
  dwState = GetClusterResourceState( hRes,
                                     NULL,
                                     0,
                                     szGroupName,
                                     &cchGroupNameSize );

  // Add error check.

  hCluster = OpenCluster( g_szClusterName );

  // Add error check.

  hGrp = OpenClusterGroup( hCluster, szGroupName );

  // After error check, use group handle...

 }

リソースのハンドルを返します。

GetResourceHandle が成功した場合は、 lObjIndex で表されるリソースのハンドルを返します。

GetResourceHandle が失敗した場合は、 NULL を返します。エラーの詳細については、 関数 GetLastError を呼び出してください。

リソースの種類を返します。

GetResourceTypeName が失敗した場合は、これ以外の HRESULT 値を返すことがあります。

リソースが依存する Network Name リソースによって管理されているネットワークの名前を返します。

GetResourceNetworkName メソッドは、 フェールオーバー クラスター アドミニストレーターの拡張プロパティ ページが、 リソースに Network Name リソースへの既存の依存関係または保留中の依存関係があるかどうかを判断できるようにするために必要です。

ネットワークの名前は、Network Name リソースの Name プライベート プロパティに格納されます。Network Name リソースの Name 共通プロパティは、ネットワークの名前ではなくリソースの名前です。

MAX_COMPUTERNAME_LENGTH は、Windows ヘッダー ファイル WinBase.h で 15 として定義されている定数です。