通过

ClusterResourceTypeControl 函数 (clusapi.h)

  • 项目

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

语法

DWORD ClusterResourceTypeControl(
  [in]            HCLUSTER hCluster,
  [in]            LPCWSTR  lpszResourceTypeName,
  [in, optional]  HNODE    hHostNode,
  [in]            DWORD    dwControlCode,
  [in, optional]  LPVOID   lpInBuffer,
  [in]            DWORD    nInBufferSize,
  [out, optional] LPVOID   lpOutBuffer,
  [in]            DWORD    nOutBufferSize,
  [out, optional] LPDWORD  lpBytesReturned
);

参数

[in] hCluster

包含 lpszResourceTypeName 中标识的资源类型的群集的句柄。

[in] lpszResourceTypeName

指向以 NULL 结尾的 Unicode 字符串的指针，该字符串包含要受影响的资源类型的名称。

[in, optional] hHostNode

托管受影响资源类型的节点的句柄。

[in] dwControlCode

指定要执行的操作 的资源类型控制代码 。 有关与控件代码关联的语法，请参阅
控制代码体系结构 和以下主题：

[in, optional] lpInBuffer

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

[in] nInBufferSize

lpInBuffer 指向的缓冲区中的字节数。

[out, optional] lpOutBuffer

指向包含操作所生成信息的输出缓冲区的指针;如果未返回任何内容，则为 NULL 。

[in] nOutBufferSize

lpOutBuffer 指向的输出缓冲区中的字节数;如果调用方不知道将返回多少数据，则为零。

[out, optional] lpBytesReturned

指向 lpOutBuffer 指向的缓冲区中由于操作而实际填充的字节数的指针。 如果 ClusterResourceTypeControl 不需要传回输出缓冲区中的字节数，则调用方可以为 lpBytesReturned 传递 NULL。

返回值

函数返回以下值之一。

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

注解

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

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

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

要求

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

另请参阅

OpenCluster

资源类型控制代码