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

Статья
02/28/2024

Создает и запускает кластер. Кластер состоит из указанного набора узлов с сетевым именем, IP-адресом и ресурсами кворума , если они указаны. Тип PCLUSAPI_CREATE_CLUSTER определяет указатель на эту функцию.

Синтаксис

HCLUSTER CreateCluster(
  [in]           PCREATE_CLUSTER_CONFIG           pConfig,
  [in, optional] PCLUSTER_SETUP_PROGRESS_CALLBACK pfnProgressCallback,
  [in, optional] PVOID                            pvCallbackArg
);

Параметры

[in] pConfig

Адрес структуры CREATE_CLUSTER_CONFIG , содержащей сведения о конфигурации создаваемого кластера.

[in, optional] pfnProgressCallback

Адрес функции обратного вызова, которая соответствует PCLUSTER_SETUP_PROGRESS_CALLBACK указателю функции, который будет периодически вызываться для обеспечения хода создания кластера.

[in, optional] pvCallbackArg

Аргумент для функции обратного вызова.

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

Дескриптор для только что созданного кластера или null. Значение, отличное от NULL , не означает, что все узлы будут добавлены, но не все ресурсы IP-адресов или сетевых имен могут быть созданы. Необходимо проверить параметры, передаваемые функции, на которую указывает параметр pfnProgressCallback .

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

Функция CreateCluster успешно завершается после достижения кворума кластера. Один или несколько узлов кластера могут находиться в состоянии ClusterNodeDown или ClusterNodeJoining в течение нескольких секунд.

Перед вызовом функции CreateCluster необходимо вызвать функцию CoInitializeEx , указав COINIT_MULTITHREADED и COINIT_DISABLE_OLE1DDE для параметра dwCoInit , как показано в следующем коде.

CoInitializeEx( NULL, COINIT_MULTITHREADED | COINIT_DISABLE_OLE1DDE );

Требования

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