通过

ClusterResourceControl 函数 (clusapi.h)

  • 项目

启动影响 资源的操作。 执行的操作取决于传递给 dwControlCode 参数的控制代码。

语法

DWORD ClusterResourceControl(
  [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 枚举，指定要执行的操作。 有关与控件代码关联的语法，请参阅
控制代码体系结构 和以下主题：

[in, optional] lpInBuffer

指向包含操作所需信息的输入缓冲区的指针;如果不需要任何信息，则为 NULL 。

[in] cbInBufferSize

输入缓冲区) ，分配的大小 (字节数。

[out, optional] lpOutBuffer

指向用于接收操作生成的数据的输出缓冲区的指针;如果未返回任何数据，则为 NULL 。

[in] cbOutBufferSize

分配的大小 (输出缓冲区) 字节数。

[out, optional] lpBytesReturned

返回操作产生的数据的实际大小 () 字节数。 如果不需要此信息，请为 lpBytesReturned 传递 NULL。

返回值

函数返回以下值之一。

返回代码/值 说明
ERROR_SUCCESS
0
 操作成功。 如果操作需要输出缓冲区，则 输入) lpBytesReturned (如果不是 NULL ，则指向缓冲区中返回的数据的实际大小。
ERROR_MORE_DATA
234 (0xEA)
 lpOutBuffer 指向的输出缓冲区不够大，无法容纳操作产生的数据。 如果输入) lpBytesReturned 参数 (为 NULL ，则指向输出缓冲区所需的大小。 只有需要输出缓冲区的操作才会返回 ERROR_MORE_DATA。 如果 lpOutBuffer 参数为 NULL 且 cbOutBufferSize 参数为零，则可能会返回 ERROR_SUCCESS ，而不是 ERROR_MORE_DATA。
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 ，则不可靠。

注解

当 ClusterResourceControl 返回 ERROR_MORE_DATA时，将 cbOutBufferSize 设置为 lpBytesReturned 指向的字节数，然后再次调用该函数。

不要将 LPC 和 RPC 句柄传递给同一函数调用。 否则，调用将引发 RPC 异常，并可能产生额外的破坏性影响。 有关如何创建 LPC 和 RPC 句柄的信息，请参阅 LPC 和 RPC 句柄 和 OpenCluster。

ClusterResourceControl 函数是控制代码函数之一。 有关控制代码和控制代码函数的详细信息，请参阅 使用控制代码。

要求

要求 值
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows Server 2008 Enterprise、Windows Server 2008 Datacenter
目标平台 Windows
标头 clusapi.h
Library ClusAPI.lib
DLL ClusAPI.dll

另请参阅

OpenCluster

资源控制代码