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


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

Перемещает ресурс из одной группы в другую. Тип PCLUSAPI_CHANGE_CLUSTER_RESOURCE_GROUP определяет указатель на эту функцию.

Синтаксис

DWORD ChangeClusterResourceGroup(
  [in] HRESOURCE hResource,
  [in] HGROUP    hGroup
);

Параметры

[in] hResource

Дескриптор перемещаемого ресурса.

[in] hGroup

Дескриптор группы, которая должна получить ресурс, определенный hResource.

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

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

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

Комментарии

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

Не вызывайте ChangeClusterResourceGroup из библиотеки DLL ресурсов. Дополнительные сведения см. в разделе Вызовы функций, которые следует избегать в библиотеках DLL ресурсов. Если ресурс, определенный hResource , имеет зависимости, все ресурсы в дереве зависимостей перемещаются в группу, определяемую hGroup. Например, в ситуации, показанной на следующей схеме, изменение ресурса B на группу 2 приведет к перемещению всего дерева зависимостей (ресурсы A, X и Y).

Схема, показывающая дерево зависимостей между ресурсами в группе ресурсов кластера до и после перемещения ресурса в другую группу.

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

Требования

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

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

OpenCluster

OpenClusterGroup

OpenClusterResource