ClusterGroupSetControl 函数 (clusapi.h)

启动影响组集的操作。

执行的操作取决于传递给 dwControlCode 参数的控制代码

语法

DWORD ClusterGroupSetControl(
  [in]            HGROUPSET hGroupSet,
  [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] hGroupSet

要受影响的组集的句柄。

[in, optional] hHostNode

如果不是 NULL,则句柄节点以执行由控制代码表示的操作。 如果 为 NULL,则拥有组集的 节点 将执行该操作。 指定 hHostNode 是可选的。

[in] dwControlCode

指定要执行的操作的 集合控制代码 。 有关与控件代码关联的语法,请参阅
控制代码体系结构 和以下主题。

[in, optional] lpInBuffer

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

[in] cbInBufferSize

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

[out, optional] lpOutBuffer

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

[in] cbOutBufferSize

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

[out, optional] lpBytesReturned

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

返回值

函数返回以下值之一。

返回代码 说明
ERROR_SUCCESS
操作成功。 如果操作需要输出缓冲区,则 输入) lpBytesReturned (如果不是 NULL ,则指向缓冲区中返回的数据的实际大小。
ERROR_MORE_DATA
lpOutBuffer 指向的输出缓冲区不够大,无法容纳操作产生的数据。 lpBytesReturned 参数 (输入) 指向输出缓冲区所需的大小(如果不是 NULL)。 只有需要输出缓冲区的操作才会返回 ERROR_MORE_DATA。 如果 lpOutBuffer 参数为 NULLnOutBufferSize 参数为零,则可能会返回 ERROR_SUCCESS ,而不是 ERROR_MORE_DATA
系统错误代码
操作未成功。 如果操作需要输出缓冲区,则 lpBytesReturned 指定的值 (如果输入) 不为 NULL ,则不可靠。

要求

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