Функция OpenCluster (clusapi.h)
Открывает подключение к кластеру и возвращает ему дескриптор.
Синтаксис
HCLUSTER OpenCluster(
[in, optional] LPCWSTR lpszClusterName
);
Параметры
[in, optional] lpszClusterName
Задает одно из следующих значений:
- Указатель на строку Юникода с завершением NULL, содержащую имя кластера или одного из узлов кластера, выраженное в виде NetBIOS-имени, полного DNS-имени или IP-адреса. Это создает дескриптор кластера RPC.
- NULL, который создает дескриптор LPC для кластера, к которому принадлежит локальный компьютер.
Возвращаемое значение
Если операция прошла успешно, OpenCluster возвращает дескриптор кластера.
| Возвращаемый код или значение | Описание |
|---|---|
|
Операция не была успешной. Для получения дополнительных сведений об ошибке вызовите функцию 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 |