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

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

  • Статья

Извлекает имя и версию кластера . Тип PCLUSAPI_GET_CLUSTER_INFORMATION определяет указатель на эту функцию.

Синтаксис

DWORD GetClusterInformation(
  [in]            HCLUSTER             hCluster,
  [out]           LPWSTR               lpszClusterName,
  [in, out]       LPDWORD              lpcchClusterName,
  [out, optional] LPCLUSTERVERSIONINFO lpClusterInfo
);

Параметры

[in] hCluster

Дескриптор в кластер.

[out] lpszClusterName

Указатель на строку Юникода, завершающуюся null, которая содержит имя кластера, определяемого hCluster.

[in, out] lpcchClusterName

Указатель на размер буфера lpszClusterName в виде количества символов. На входных данных укажите максимальное количество символов, которые может содержать буфер, включая завершающее значение NULL. В выходных данных указывает количество символов в итоговом имени, за исключением завершающего значения NULL.

[out, optional] lpClusterInfo

Значение NULL или указатель на структуру CLUSTERVERSIONINFO , описывающую версию службы кластеров. Если значение lpClusterInfo не равно NULL, член dwVersionInfoSize этой структуры должен быть задан следующим образом: lpClusterInfo->dwVersionInfoSize = sizeof(CLUSTERVERSIONINFO);

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

Если операция выполнена успешно, функция возвращает ERROR_SUCCESS (0).

Если операция завершается сбоем, функция возвращает код системной ошибки. Ниже приведено одно из возможных значений.

Код возврата Описание
ERROR_MORE_DATA
 Буфер, на который указывает lpszClusterName , недостаточно велик для хранения результата. Параметр lpcchClusterName возвращает количество символов в результате, за исключением завершающего значения NULL.

Комментарии

Обратите внимание, что lpcchClusterName относится к количеству символов, а не к числу байтов, а возвращаемый размер не включает завершающее значение NULL в число. Дополнительные сведения о размерах буферов см. в разделе Соглашения о размерах данных.

Требования

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

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

CLUSTERVERSIONINFO