ClusterResourceControlAsUser 関数 (clusapi.h)
リソースに影響を与える操作を開始 します。
実行される操作は、dwControlCode パラメーターに渡されるコントロール コードによって異なります。
構文
DWORD ClusterResourceControlAsUser(
[in] HRESOURCE hResource,
[in, optional] HNODE hHostNode,
[in] DWORD dwControlCode,
[in, optional] LPVOID lpInBuffer,
[in] DWORD cbInBufferSize,
[out, optional] LPVOID lpOutBuffer,
[in] DWORD cbOutBufferSize,
[out, optional] LPDWORD lpBytesReturned
);
パラメーター
[in] hResource
影響を受けるリソースを処理します。
[in, optional] hHostNode
操作を実行するノードへの省略可能なハンドル。 NULL の場合、hResource によって識別されるリソースを所有するノードが操作を実行します。
[in] dwControlCode
実行する操作を指定する、CLUSCTL_RESOURCE_CODES列挙によって列挙されたリソース制御コード。 コントロール コードに関連付けられている構文については、 を参照してください。
CLUSCTL_RESOURCE_CODES トピックのリンク。
[in, optional] lpInBuffer
操作に必要な情報を含む入力バッファーへのポインター。情報が必要ない場合は NULL 。
[in] cbInBufferSize
入力バッファーの割り当てられたサイズ (バイト単位)。
[out, optional] lpOutBuffer
操作の結果として得られるデータを受け取る出力バッファーへのポインター。データが返されない場合は NULL 。
[in] cbOutBufferSize
出力バッファーの割り当てられたサイズ (バイト単位)。
[out, optional] lpBytesReturned
操作に起因するデータの実際のサイズ (バイト単位) を返します。 この情報が必要ない場合は、lpBytesReturned に NULL を渡します。
戻り値
関数は、次のいずれかの値を返します。
| リターン コード/値 | Description |
|---|---|
|
操作に成功しました。 操作で出力バッファーが必要な場合、 lpBytesReturned (入力時に NULL でない場合) は、バッファーに返されるデータの実際のサイズを指します。 |
|
lpOutBuffer が指す出力バッファーが、操作の結果として得られるデータを保持するのに十分な大きさではなかった。 lpBytesReturned パラメーター (入力時に NULL でない場合) は、出力バッファーに必要なサイズを指します。 出力バッファーを必要とする操作のみが ERROR_MORE_DATAを返します。 lpOutBuffer パラメーターが NULL で、cbOutBufferSize パラメーターが 0 の場合は、ERROR_MORE_DATAではなく、ERROR_SUCCESSが返されることがあります。 |
|
CLUSCTL_RESOURCE_SET_COMMON_PROPERTIESとCLUSCTL_RESOURCE_SET_PRIVATE_PROPERTIESにのみ適用されます。 プロパティが正常に格納されたが、リソースにまだ適用されていないことを示します。 新しいプロパティは、リソースがオフラインになり、再びオンラインにされた後に有効になります。 |
|
hNode パラメーターで指定されたノードは、hResource で指定されたリソースを所有するノードではありません。 |
| 操作が成功しなかった。 操作で出力バッファーが必要な場合、 lpBytesReturned (入力時に NULL でない場合) で指定された値は信頼できません。 |
注釈
ClusterResourceControl がERROR_MORE_DATAを返す場合は、cbOutBufferSize を lpBytesReturned が指すバイト数に設定し、関数をもう一度呼び出します。
LPC ハンドルと RPC ハンドルを同じ関数呼び出しに渡さないでください。 それ以外の場合、呼び出しによって RPC 例外が発生し、破壊的効果が追加される可能性があります。 LPC および RPC ハンドルの作成方法については、「LPC および RPC ハンドル」および「OpenCluster」を参照してください。
ClusterResourceControl 関数は、コントロール コード関数の 1 つです。 コントロール コードとコントロール コード関数の詳細については、「コントロール コードの 使用」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows Server 2016 |
| 対象プラットフォーム | Windows |
| ヘッダー | clusapi.h |
| Library | ClusAPI.lib |
| [DLL] | ClusAPI.dll |