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

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

  • Статья

Устанавливает ресурс в качестве ресурса кворума для кластера. Тип 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)
 Ресурс кворума не подключен к сети.

Комментарии

Не вызывайте SetClusterQuorumResource из библиотеки DLL ресурса. Дополнительные сведения см. в разделе Вызовы функций, которые следует избегать в библиотеках DLL ресурсов.

Требования

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

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

GetClusterQuorumResource