Функция CreateCluster (clusapi.h)
Создает и запускает кластер. Кластер состоит из указанного набора узлов с сетевым именем, 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 .
| Код возврата | Описание |
|---|---|
|
Было успешно создано менее чем большинство узлов. Для получения дополнительных сведений об ошибке вызовите функцию GetLastError. |
Комментарии
Тип PCLUSAPI_CREATE_CLUSTER определяет указатель на эту функцию и может использоваться с функцией GetProcAddress для вызова этой функции.
После успешного завершения функции CreateCluster должно быть разрешено не менее 30 секунд до вызова функции AddClusterNode для добавления дополнительных узлов.
Функция 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 |