通过

openCluster 函数 (clusapi.h)

  • 项目

打开与群集的连接，并返回该 群集 的句柄。

语法

HCLUSTER OpenCluster(
  [in, optional] LPCWSTR lpszClusterName
);

参数

[in, optional] lpszClusterName

指定以下值之一：

  • 指向以 null 结尾的 Unicode 字符串的指针，该字符串包含群集的名称或表示为 NetBIOS 名称、完全限定的 DNS 名称或 IP 地址的群集 节点 之一。 这会生成 RPC 群集句柄。
  • NULL，生成本地计算机所属群集的 LPC 句柄。

返回值

如果操作成功， OpenCluster 将返回群集句柄。

返回代码/值 说明
NULL
0
 操作未成功。 有关错误的详细信息，请调用函数 GetLastError。

注解

群集句柄是指向内部定义的结构的指针，该结构存储有关与群集的 RPC 或 LPC 连接的信息。 从群集句柄获取的任何对象句柄都将与群集结构中存储的 RPC 或 LPC 会话数据相关联。 组合 RPC 和 LPC 句柄或使用从不同上下文获取的句柄可能会导致异常或其他不可预知的结果。 有关详细信息，请参阅 LPC 和 RPC 句柄。

完成群集句柄后，请务必调用 CloseCluster ，以确保释放所有内存并完全关闭连接。

如果群集是远程群集，则客户端必须运行兼容的操作系统。 例如，运行 Windows Server 2008 的计算机无法针对运行 Windows Server 2016 的群集调用 OpenCluster。 若要远程管理这些群集，请使用 故障转移群集 WMI 提供程序。

示例

请参阅 使用对象句柄。

要求

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

另请参阅

CloseCluster

故障转移群集管理功能

OpenClusterEx