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

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

  • Статья

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

Синтаксис

DWORD AddClusterResourceDependency(
  [in] HRESOURCE hResource,
  [in] HRESOURCE hDependsOn
);

Параметры

[in] hResource

Дескриптор для зависимого ресурса.

[in] hDependsOn

Дескриптор ресурса, от которых должен зависеть ресурс, определенный hResource .

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

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

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

Возвращаемый код/значение Описание
ERROR_CIRCULAR_DEPENDENCY
1059 (0x423)
 Ресурс зависит от самого себя.
ERROR_DEPENDENCY_ALREADY_EXISTS
5003 (0x138B)
 Зависимость ресурса уже существует.
ERROR_DEPENDENCY_NOT_ALLOWED
5069 (0x13CD)
 Зависимым ресурсом является кворум.
ERROR_INVALID_PARAMETER
87 (0x57)
 Ресурсы находятся не в одной группе.
ERROR_RESOURCE_NOT_AVAILABLE
5006 (0x138E)
 По крайней мере один из ресурсов помечен для удаления.
ERROR_RESOURCE_ONLINE
5019 (0x139B)
 Зависимый ресурс уже подключен к сети.

Комментарии

Связь зависимостей, созданная функцией AddClusterResourceDependency , влияет на то, как ресурсы перемещаются с одного узла на другой после сбоя. Он определяет порядок, в котором ресурсы переключаются в автономный режим и возвращаются в режим "в сети".

Ресурсы в связи зависимостей должны перемещаться вместе. Зависимый ресурс должен быть подключен после ресурса, от которого он зависит.

Два ресурса, определяемых hResource и hDependsOn, должны находиться в одной группе.

Не вызывайте Метод AddClusterResourceDependency, если hResource уже подключен к сети. Вызов завершается ошибкой ERROR_RESOURCE_ONLINE . Обратите внимание, что в Windows Server 2008 это поведение изменилось. Вы можете вызвать Метод AddClusterResourceDependency и изменить зависимости ресурсов, не требуя, чтобы ресурс был отключен.

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

Не передавайте дескрипторы LPC и RPC в один и тот же вызов функции. В противном случае вызов вызовет исключение RPC и может иметь дополнительные разрушительные последствия. Сведения о создании дескрипторов LPC и RPC см. в разделе Использование дескрипторов объектов и OpenCluster.

Требования

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

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

CanResourceBeDependent

OpenCluster

OpenClusterResource

RemoveClusterResourceDependency