Поделиться через

Функция OpenCluster (clusapi.h)

  • Статья

Открывает подключение к кластеру и возвращает ему дескриптор.

Синтаксис

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

Параметры

[in, optional] lpszClusterName

Задает одно из следующих значений:

  • Указатель на строку Юникода с завершением NULL, содержащую имя кластера или одного из узлов кластера, выраженное в виде NetBIOS-имени, полного DNS-имени или IP-адреса. Это создает дескриптор кластера RPC.
  • NULL, который создает дескриптор LPC для кластера, к которому принадлежит локальный компьютер.

Возвращаемое значение

Если операция прошла успешно, OpenCluster возвращает дескриптор кластера.

Возвращаемый код или значение Описание
NULL
0
 Операция не была успешной. Для получения дополнительных сведений об ошибке вызовите функцию GetLastError.

Комментарии

Дескриптор кластера — это указатель на внутреннюю структуру, в которой хранятся сведения о подключении RPC или LPC к кластеру. Все дескрипторы объектов, полученные из дескриптора кластера, будут связаны с данными сеанса RPC или LPC, хранящимися в структуре кластера. Объединение дескрипторов RPC и LPC или использование дескрипторов, полученных из разных контекстов, может привести к исключениям или другим непредсказуемым результатам. Дополнительные сведения см. в разделе Дескрипторы LPC и RPC.

Завершив работу с дескриптором кластера, важно вызвать CloseCluster , чтобы обеспечить освобождение всей памяти и завершение подключения.

Если кластер удален, клиент должен работать под управлением совместимой операционной системы. Например, компьютеры под управлением Windows Server 2008 не могут вызывать OpenCluster в кластере под управлением Windows Server 2016. Для удаленного управления этими кластерами используйте поставщик WMI отказоустойчивого кластера.

Примеры

См . раздел Использование дескрипторов объектов.

Требования

Требование Значение
Минимальная версия клиента Ни одна версия не поддерживается
Минимальная версия сервера Windows Server 2008 Корпоративная, Windows Server 2008 Datacenter
Целевая платформа Windows
Header clusapi.h
Библиотека ClusAPI.lib
DLL ClusAPI.dll

См. также раздел

CloseCluster

Функции управления отказоустойчивости кластеров

OpenClusterEx