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

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

  • Статья

Инициирует операцию в сети. Выполняемая операция зависит от кода элемента управления , переданного параметру dwControlCode .

Синтаксис

DWORD ClusterNetworkControl(
  [in]                HNETWORK hNetwork,
  [in, optional]      HNODE    hHostNode,
  [in]                DWORD    dwControlCode,
  [in, optional]      LPVOID   lpInBuffer,
  [in]                DWORD    nInBufferSize,
  [out, optional]     LPVOID   lpOutBuffer,
  [in]                DWORD    nOutBufferSize,
  [in, out, optional] LPDWORD  lpBytesReturned
);

Параметры

[in] hNetwork

Дескриптор для сети, на которую будет влиять операция.

[in, optional] hHostNode

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

[in] dwControlCode

Код управления сетью, указывающий выполняемую операцию. Синтаксис, связанный с кодом элемента управления, см. в разделе
Архитектура кода управления и следующие разделы:

[in, optional] lpInBuffer

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

[in] nInBufferSize

Выделенный размер (в байтах) входного буфера.

[out, optional] lpOutBuffer

Указатель на выходной буфер для получения данных, полученных в результате операции, или значение NULL , если данные не будут возвращены.

[in] nOutBufferSize

Выделенный размер (в байтах) выходного буфера.

[in, out, optional] lpBytesReturned

Возвращает фактический размер (в байтах) данных, полученных в результате операции. Если эти сведения не требуются, передайте значение NULL для параметра lpBytesReturned.

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

Функция возвращает одно из следующих значений.

Код возврата Описание
ERROR_SUCCESS
 Операция выполнена успешно. Если операции требуется выходной буфер, lpBytesReturned (если не NULL на входных данных) указывает на фактический размер данных, возвращаемых в буфере.
ERROR_MORE_DATA
 Выходной буфер, на который указывает lpOutBuffer , не был достаточно велик для хранения данных, полученных в результате операции. Параметр lpBytesReturned (если не NULL для входных данных) указывает на размер, необходимый для выходного буфера. Только операции, для которых требуется выходной буфер , возвращают ERROR_MORE_DATA. Если параметр lpOutBuffer имеет значение NULL , а параметр nOutBufferSize равен нулю, может возвращаться ERROR_SUCCESS , а не ERROR_MORE_DATA.
Код системной ошибки
 Операция не была успешной. Если для операции требуется выходной буфер, значение, указанное в параметре lpBytesReturned (если на входе не задано значение NULL ), является ненадежным.

Комментарии

Если ClusterNetworkControl возвращает ERROR_MORE_DATA, задайте для nOutBufferSize значение числа байтов, на которое указывает lpBytesReturned, и вызовите функцию еще раз.

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

ClusterNetworkControl — это одна из функций кода элемента управления. Дополнительные сведения о кодах элементов управления и функциях кода элементов управления см. в разделе Использование кодов элементов управления.

Требования

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

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

Коды управления сетью

OpenCluster