次の方法で共有

ClusterResourceTypeControl 関数 (clusapi.h)

  • [アーティクル]

リソースの種類に影響を与える操作を開始します。 実行される操作は、dwControlCode パラメーターに渡されるコントロール コードによって異なります。

構文

DWORD ClusterResourceTypeControl(
  [in]            HCLUSTER hCluster,
  [in]            LPCWSTR  lpszResourceTypeName,
  [in, optional]  HNODE    hHostNode,
  [in]            DWORD    dwControlCode,
  [in, optional]  LPVOID   lpInBuffer,
  [in]            DWORD    nInBufferSize,
  [out, optional] LPVOID   lpOutBuffer,
  [in]            DWORD    nOutBufferSize,
  [out, optional] LPDWORD  lpBytesReturned
);

パラメーター

[in] hCluster

lpszResourceTypeName で識別されるリソースの種類を含むクラスターへのハンドル。

[in] lpszResourceTypeName

影響を受けるリソースの種類の名前を含む NULL で終わる Unicode 文字列へのポインター。

[in, optional] hHostNode

影響を受けるリソースの種類をホストしているノードを処理します。

[in] dwControlCode

実行する操作を指定する リソースの種類の制御コード 。 コントロール コードに関連付けられている構文については、 を参照してください。
コード アーキテクチャ と次のトピックを制御します。

[in, optional] lpInBuffer

操作に必要な情報を含む入力バッファーへのポインター。情報が必要ない場合は NULL 。

[in] nInBufferSize

lpInBuffer が指すバッファー内のバイト数。

[out, optional] lpOutBuffer

操作の結果として得られる情報を含む出力バッファーへのポインター。何も返されない場合は NULL 。

[in] nOutBufferSize

lpOutBuffer が指す出力バッファー内のバイト数。呼び出し元が返されるデータの量がわからない場合は 0。

[out, optional] lpBytesReturned

操作の結果として実際に入力された lpOutBuffer が指すバッファー内のバイト数へのポインター。 ClusterResourceTypeControl が出力バッファー内のバイト数を返す必要がない場合、呼び出し元は lpBytesReturned に NULL を渡すことができます。

戻り値

関数は、次のいずれかの値を返します。

リターン コード 説明
ERROR_SUCCESS
 操作に成功しました。 操作で出力バッファーが必要な場合、 lpBytesReturned (入力時に NULL でない場合) は、バッファーに返されるデータの実際のサイズを指します。
ERROR_MORE_DATA
 lpOutBuffer が指す出力バッファーが、操作の結果として得られるデータを保持するのに十分な大きさではなかった。 lpBytesReturned パラメーター (入力時に NULL でない場合) は、出力バッファーに必要なサイズを指します。 出力バッファーを必要とする操作のみが ERROR_MORE_DATAを返します。 lpOutBuffer パラメーターが NULL で、nOutBufferSize パラメーターが 0 の場合は、ERROR_MORE_DATAではなく、ERROR_SUCCESSが返される可能性があります。
システム エラー コード
 操作が成功しなかった。 操作で出力バッファーが必要な場合、 lpBytesReturned で指定された値は信頼できません。

注釈

ClusterResourceTypeControl がERROR_MORE_DATAを返す場合は、lpBytesReturned が指すバイト数に nOutBufferSize を設定し、関数をもう一度呼び出します。

LPC ハンドルと RPC ハンドルを同じ関数呼び出しに渡さないでください。 それ以外の場合、呼び出しによって RPC 例外が発生し、破壊的効果が追加される可能性があります。 LPC および RPC ハンドルの作成方法については、「LPC および RPC ハンドル」および「OpenCluster」を参照してください。

ClusterResourceTypeControl は 、コントロール コード関数の 1 つです。 コントロール コードとコントロール コード関数の詳細については、「コントロール コードの 使用」を参照してください。

要件

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

こちらもご覧ください

OpenCluster

リソースの種類の制御コード