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

Статья
08/22/2023

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

Синтаксис

DWORD SetClusterQuorumResource(
  [in]           HRESOURCE hResource,
  [in, optional] LPCWSTR   lpszDeviceName,
  [in]           DWORD     dwMaxQuoLogSize
);

Параметры

[in] hResource

Дескриптор нового ресурса кворума; или существующий ресурс кворума при CLUS_NODE_MAJORITY_QUORUMdwMaxQuoLogSize.

[in, optional] lpszDeviceName

Определяет букву диска и путь, которые служба кластеров будет использовать для хранения файлов кворума в новом ресурсе кворума. Передайте строку Юникода, завершаемую null, или null, как показано ниже.

Если в пути указана буква диска, служба кластеров проверит, что буква диска ссылается на допустимый раздел в новом ресурсе кворума.
Если в пути не указана буква диска, служба кластеров будет использовать секцию по умолчанию для нового ресурса кворума (см. ниже).
Если значение РАВНО NULL, служба кластеров будет использовать секцию по умолчанию и имя пути по умолчанию (см. ниже).

Служба кластеров использует секцию, помеченную как CLUSPROP_PIFLAG_DEFAULT_QUORUM в качестве секции по умолчанию (см. раздел CLUSPROP_PARTITION_INFO), или, если флаг не найден, первый доступный раздел NTFS в новом ресурсе кворума.

Для имени пути по умолчанию служба кластеров использует предыдущее имя пути, если таковое существует. в противном случае используется "MSCS".

[in] dwMaxQuoLogSize

Значение типа кворума. Укажите одну из трех перечисленных констант. При указании CLUS_NODE_MAJORITY_QUORUM hResource должен ссылаться на существующий ресурс кворума.

CLUS_HYBRID_QUORUM (1024 (0x400))

CLUS_NODE_MAJORITY_QUORUM (0 (0x0))

CLUS_LEGACY_QUORUM (4194304 (0x400000))

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

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

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

Возвращаемый код/значение	Описание
ERROR_RESOURCE_NOT_ONLINE 5004 (0x138C)	Ресурс кворума не подключен к сети.

Требования

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

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

GetClusterQuorumResource

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