ホーム › Networking.Clustering › PCLUSAPI_CLUSTER_RESOURCE_CONTROL

PCLUSAPI_CLUSTER_RESOURCE_CONTROL

コールバック

シグネチャ

DWORD PCLUSAPI_CLUSTER_RESOURCE_CONTROL(
    HRESOURCE hResource,
    HNODE hHostNode,
    DWORD dwControlCode,
    void* lpInBuffer,
    DWORD cbInBufferSize,
    void* lpOutBuffer,
    DWORD cbOutBufferSize,
    DWORD* lpBytesReturned
);

パラメーター

フィールド	型	説明
hResource	HRESOURCE	操作の対象となるリソースのハンドルです。
hHostNode	HNODE	操作を実行するノードのハンドルです(省略可能)。NULL の場合は、 hResource で指定されたリソースを所有するノードが操作を実行します。
dwControlCode	DWORD	実行する操作を指定するリソース制御コードです。このコードは CLUSCTL_RESOURCE_CODES 列挙型で列挙されます。制御コードに対応する構文については、 Control Code Architecture と次のトピックを参照してください。 CLUSCTL_RESOURCE_UNKNOWN CLUSCTL_RESOURCE_GET_CHARACTERISTICS CLUSCTL_RESOURCE_GET_FLAGS CLUSCTL_RESOURCE_GET_CLASS_INFO CLUSCTL_RESOURCE_GET_REQUIRED_DEPENDENCIES CLUSCTL_RESOURCE_GET_NAME CLUSCTL_RESOURCE_GET_ID CLUSCTL_RESOURCE_GET_RESOURCE_TYPE CLUSCTL_RESOURCE_ENUM_COMMON_PROPERTIES CLUSCTL_RESOURCE_GET_RO_COMMON_PROPERTIES CLUSCTL_RESOURCE_GET_COMMON_PROPERTIES CLUSCTL_RESOURCE_SET_COMMON_PROPERTIES CLUSCTL_RESOURCE_VALIDATE_COMMON_PROPERTIES CLUSCTL_RESOURCE_GET_COMMON_PROPERTY_FMTS CLUSCTL_RESOURCE_ENUM_PRIVATE_PROPERTIES CLUSCTL_RESOURCE_GET_RO_PRIVATE_PROPERTIES CLUSCTL_RESOURCE_GET_PRIVATE_PROPERTIES CLUSCTL_RESOURCE_SET_PRIVATE_PROPERTIES CLUSCTL_RESOURCE_VALIDATE_PRIVATE_PROPERTIES CLUSCTL_RESOURCE_GET_PRIVATE_PROPERTY_FMTS CLUSCTL_RESOURCE_ADD_REGISTRY_CHECKPOINT CLUSCTL_RESOURCE_DELETE_REGISTRY_CHECKPOINT CLUSCTL_RESOURCE_GET_REGISTRY_CHECKPOINTS CLUSCTL_RESOURCE_ADD_CRYPTO_CHECKPOINT CLUSCTL_RESOURCE_DELETE_CRYPTO_CHECKPOINT CLUSCTL_RESOURCE_GET_CRYPTO_CHECKPOINTS CLUSCTL_RESOURCE_GET_LOADBAL_PROCESS_LIST CLUSCTL_RESOURCE_GET_NETWORK_NAME CLUSCTL_RESOURCE_NETNAME_GET_VIRTUAL_SERVER_TOKEN CLUSCTL_RESOURCE_NETNAME_SET_PWD_INFO CLUSCTL_RESOURCE_NETNAME_DELETE_CO CLUSCTL_RESOURCE_NETNAME_VALIDATE_VCO CLUSCTL_RESOURCE_NETNAME_RESET_VCO CLUSCTL_RESOURCE_NETNAME_REGISTER_DNS_RECORDS CLUSCTL_RESOURCE_GET_DNS_NAME CLUSCTL_RESOURCE_STORAGE_GET_DISK_INFO CLUSCTL_RESOURCE_STORAGE_IS_PATH_VALID CLUSCTL_RESOURCE_QUERY_DELETE CLUSCTL_RESOURCE_UPGRADE_DLL CLUSCTL_RESOURCE_IPADDRESS_RENEW_LEASE CLUSCTL_RESOURCE_IPADDRESS_RELEASE_LEASE CLUSCTL_RESOURCE_ADD_REGISTRY_CHECKPOINT_64BIT CLUSCTL_RESOURCE_ADD_REGISTRY_CHECKPOINT_32BIT CLUSCTL_RESOURCE_QUERY_MAINTENANCE_MODE CLUSCTL_RESOURCE_SET_MAINTENANCE_MODE CLUSCTL_RESOURCE_STORAGE_SET_DRIVELETTER CLUSCTL_RESOURCE_STORAGE_GET_DISK_INFO_EX CLUSCTL_RESOURCE_FILESERVER_SHARE_ADD CLUSCTL_RESOURCE_FILESERVER_SHARE_DEL CLUSCTL_RESOURCE_FILESERVER_SHARE_MODIFY CLUSCTL_RESOURCE_FILESERVER_SHARE_REPORT CLUSCTL_RESOURCE_STORAGE_GET_MOUNTPOINTS CLUSCTL_RESOURCE_STORAGE_CLUSTER_DISK CLUSCTL_RESOURCE_STORAGE_GET_DIRTY CLUSCTL_RESOURCE_SET_CSV_MAINTENANCE_MODE CLUSCTL_RESOURCE_ENABLE_SHARED_VOLUME_DIRECTIO CLUSCTL_RESOURCE_DISABLE_SHARED_VOLUME_DIRECTIO CLUSCTL_RESOURCE_SET_SHARED_VOLUME_BACKUP_MODE CLUSCTL_RESOURCE_DELETE CLUSCTL_RESOURCE_INSTALL_NODE CLUSCTL_RESOURCE_EVICT_NODE CLUSCTL_RESOURCE_ADD_DEPENDENCY CLUSCTL_RESOURCE_REMOVE_DEPENDENCY CLUSCTL_RESOURCE_ADD_OWNER CLUSCTL_RESOURCE_REMOVE_OWNER CLUSCTL_RESOURCE_SET_NAME CLUSCTL_RESOURCE_CLUSTER_NAME_CHANGED CLUSCTL_RESOURCE_CLUSTER_VERSION_CHANGED CLUSCTL_RESOURCE_FORCE_QUORUM CLUSCTL_RESOURCE_INITIALIZE CLUSCTL_RESOURCE_STATE_CHANGE_REASON CLUSCTL_RESOURCE_PROVIDER_STATE_CHANGE CLUSCTL_RESOURCE_LEAVING_GROUP CLUSCTL_RESOURCE_JOINING_GROUP CLUSCTL_RESOURCE_FSWITNESS_GET_EPOCH_INFO CLUSCTL_RESOURCE_FSWITNESS_SET_EPOCH_INFO CLUSCTL_RESOURCE_FSWITNESS_RELEASE_LOCK CLUSCTL_RESOURCE_NETNAME_CREDS_UPDATED
lpInBuffer	void*	操作に必要な情報を格納した入力バッファーへのポインターです。情報が不要な場合は NULL を指定します。
cbInBufferSize	DWORD	入力バッファーに割り当てられたサイズ(バイト単位)です。
lpOutBuffer	void*	操作の結果として得られるデータを受け取る出力バッファーへのポインターです。データが返されない場合は NULL を指定します。
cbOutBufferSize	DWORD	出力バッファーに割り当てられたサイズ(バイト単位)です。
lpBytesReturned	DWORD*	操作の結果として得られたデータの実際のサイズ(バイト単位)を返します。この情報が不要な場合は、 lpBytesReturned に NULL を渡します。

公式ドキュメント

リソースに影響する操作を開始します。実行される操作は、dwControlCode パラメーターに渡される制御コードによって決まります。

戻り値

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

戻り値/値	説明
ERROR_SUCCESS 0	操作は成功しました。操作が出力バッファーを必要とする場合、 lpBytesReturned(入力時に NULL でない場合)はバッファーに返されたデータの実際のサイズを指します。
ERROR_MORE_DATA 234 (0xEA)	lpOutBuffer が指す出力バッファーが、操作の結果として得られたデータを格納するには小さすぎました。lpBytesReturned パラメーター(入力時に NULL でない場合)は、出力バッファーに必要なサイズを指します。ERROR_MORE_DATA を返すのは、出力バッファーを必要とする操作だけです。lpOutBuffer パラメーターが NULL で cbOutBufferSize パラメーターが 0 の場合は、ERROR_MORE_DATA ではなく ERROR_SUCCESS が返されることがあります。
ERROR_RESOURCE_PROPERTIES_STORED 5024 (0x13A0)	CLUSCTL_RESOURCE_SET_COMMON_PROPERTIES と CLUSCTL_RESOURCE_SET_PRIVATE_PROPERTIES にのみ適用されます。プロパティは正常に保存されたものの、まだリソースに適用されていないことを示します。新しいプロパティは、リソースをオフラインにして再度オンラインにした後で有効になります。
ERROR_HOST_NODE_NOT_RESOURCE_OWNER 5015 (0x1397)	hNode パラメーターで指定されたノードは、hResource で指定されたリソースを所有するノードではありません。
システムエラーコード	操作は失敗しました。操作が出力バッファーを必要とする場合、lpBytesReturned (入力時に NULL でない場合)が指す値は信頼できません。

解説(Remarks)

ClusterResourceControl が ERROR_MORE_DATA を返した場合は、 cbOutBufferSize に lpBytesReturned が指すバイト数を設定して、関数を再度呼び出してください。

同じ関数呼び出しに LPC ハンドルと RPC ハンドルを混在させて渡さないでください。混在させると、呼び出しは RPC 例外を発生させ、さらに破壊的な影響を及ぼすおそれがあります。LPC ハンドルと RPC ハンドルの作成方法については、 LPC and RPC Handles と OpenCluster を参照してください。

ClusterResourceControl 関数は制御コード関数の 1 つです。制御コードと制御コード関数の詳細については、Using Control Codes を参照してください。

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