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
指定要执行的操作的 集合控制代码 。 有关与控件代码关联的语法,请参阅
控制代码体系结构 和以下主题。
- CLUSCTL_GROUPSET_GET_COMMON_PROPERTIES
- CLUSCTL_GROUPSET_GET_GROUPS
- CLUSCTL_GROUPSET_GET_PROVIDER_GROUPS
- CLUSCTL_GROUPSET_GET_PROVIDER_COLLECTIONS
- CLUSCTL_GROUPSET_GET_RO_COMMON_PROPERTIES
- CLUSCTL_GROUPSET_SET_COMMON_PROPERTIES
- CLUSCTL_GROUP_GET_PROVIDER_GROUPS
- CLUSCTL_GROUP_GET_PROVIDER_COLLECTIONS
[in, optional] lpInBuffer
指向包含操作所需信息的输入缓冲区的指针;如果不需要任何信息,则为 NULL 。
[in] cbInBufferSize
输入缓冲区) 分配的大小 (字节数。
[out, optional] lpOutBuffer
指向用于接收操作生成的数据的输出缓冲区的指针;如果未返回任何数据,则为 NULL 。
[in] cbOutBufferSize
分配的大小 (输出缓冲区) 字节数。
[out, optional] lpBytesReturned
返回实际大小 (,以字节为单位,) 操作生成的数据。 如果不需要此信息,请为 lpBytesReturned 传递 NULL。
返回值
函数返回以下值之一。
返回代码 | 说明 |
---|---|
|
操作成功。 如果操作需要输出缓冲区,则 输入) lpBytesReturned (如果不是 NULL ,则指向缓冲区中返回的数据的实际大小。 |
|
lpOutBuffer 指向的输出缓冲区不够大,无法容纳操作产生的数据。 lpBytesReturned 参数 (输入) 指向输出缓冲区所需的大小(如果不是 NULL)。 只有需要输出缓冲区的操作才会返回 ERROR_MORE_DATA。 如果 lpOutBuffer 参数为 NULL 且 nOutBufferSize 参数为零,则可能会返回 ERROR_SUCCESS ,而不是 ERROR_MORE_DATA。 |
操作未成功。 如果操作需要输出缓冲区,则 lpBytesReturned 指定的值 (如果输入) 不为 NULL ,则不可靠。 |
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 无受支持的版本 |
最低受支持的服务器 | Windows Server 2016 |
目标平台 | Windows |
标头 | clusapi.h |
Library | ClusAPI.lib |
DLL | ClusAPI.dll |