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

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

  • Статья

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

Синтаксис

DWORD GetClusterQuorumResource(
  [in]      HCLUSTER hCluster,
  [out]     LPWSTR   lpszResourceName,
  [in, out] LPDWORD  lpcchResourceName,
  [out]     LPWSTR   lpszDeviceName,
  [in, out] LPDWORD  lpcchDeviceName,
  [out]     LPDWORD  lpdwMaxQuorumLogSize
);

Параметры

[in] hCluster

Дескриптор существующего кластера.

[out] lpszResourceName

Указатель на строку Юникода, завершающуюся null, которая содержит имя ресурса кворума кластера. Имя считывается из общего свойства Name ресурса кворума. Не передайте значение NULL для этого параметра.

[in, out] lpcchResourceName

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

[out] lpszDeviceName

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

[in, out] lpcchDeviceName

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

[out] lpdwMaxQuorumLogSize

Указатель на максимальный размер (в байтах) журнала, поддерживаемого ресурсом кворума. Не передайте значение NULL для этого параметра.

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

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

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

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

Комментарии

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

Требования

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

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

имя;

SetClusterQuorumResource