Функция ClusterResourceControlAsUser (clusapi.h)
Инициирует операцию, влияющую на ресурс.
Выполняемая операция зависит от кода элемента управления , переданного параметру dwControlCode .
Синтаксис
DWORD ClusterResourceControlAsUser(
[in] HRESOURCE hResource,
[in, optional] HNODE hHostNode,
[in] DWORD dwControlCode,
[in, optional] LPVOID lpInBuffer,
[in] DWORD cbInBufferSize,
[out, optional] LPVOID lpOutBuffer,
[in] DWORD cbOutBufferSize,
[out, optional] LPDWORD lpBytesReturned
);
Параметры
[in] hResource
Дескриптор для затронутого ресурса.
[in, optional] hHostNode
Необязательный дескриптор узла для выполнения операции. Если значение РАВНО NULL, то узел, которому принадлежит ресурс, определенный hResource , выполняет операцию.
[in] dwControlCode
Код элемента управления ресурсами, перечисляемый перечислением CLUSCTL_RESOURCE_CODES, указывающий выполняемую операцию. Синтаксис, связанный с кодом элемента управления, см. в разделе
ссылка на CLUSCTL_RESOURCE_CODES разделе.
[in, optional] lpInBuffer
Указатель на входной буфер, содержащий сведения, необходимые для операции, или значение NULL , если информация не требуется.
[in] cbInBufferSize
Выделенный размер (в байтах) входного буфера.
[out, optional] lpOutBuffer
Указатель на выходной буфер для получения данных, полученных в результате операции, или значение NULL , если данные не будут возвращены.
[in] cbOutBufferSize
Выделенный размер (в байтах) выходного буфера.
[out, optional] lpBytesReturned
Возвращает фактический размер (в байтах) данных, полученных в результате операции. Если эти сведения не требуются, передайте значение NULL для параметра lpBytesReturned.
Возвращаемое значение
Функция возвращает одно из следующих значений.
| Возвращаемый код/значение | Описание |
|---|---|
|
Операция выполнена успешно. Если операции требуется выходной буфер, lpBytesReturned (если не NULL на входных данных) указывает на фактический размер данных, возвращаемых в буфере. |
|
Выходной буфер, на который указывает lpOutBuffer , не был достаточно велик для хранения данных, полученных в результате операции. Параметр lpBytesReturned (если не NULL для входных данных) указывает на размер, необходимый для выходного буфера. Только операции, для которых требуется выходной буфер , возвращают ERROR_MORE_DATA. Если параметр lpOutBuffer имеет значение NULL , а параметр cbOutBufferSize равен нулю, может быть возвращен ERROR_SUCCESS , а не ERROR_MORE_DATA. |
|
Применяется только к CLUSCTL_RESOURCE_SET_COMMON_PROPERTIES и CLUSCTL_RESOURCE_SET_PRIVATE_PROPERTIES. Указывает, что свойства успешно сохранены, но еще не применены к ресурсу. Новые свойства вступают в силу после того, как ресурс перейдет в автономный режим и снова перейдет в режим "в сети". |
|
Узел, указанный параметром hNode , не является узлом, которому принадлежит ресурс, указанный в hResource. |
| Операция не была успешной. Если для операции требуется выходной буфер, значение, указанное в параметре lpBytesReturned (если на входе не задано значение NULL ), является ненадежным. |
Комментарии
Когда ClusterResourceControl возвращает ERROR_MORE_DATA, задайте для параметра cbOutBufferSize значение числа байтов, на которое указывает lpBytesReturned, и снова вызовите функцию.
Не передавайте дескрипторы LPC и RPC в один и тот же вызов функции. В противном случае вызов вызовет исключение RPC и может иметь дополнительные разрушительные последствия. Сведения о создании дескрипторов LPC и RPC см. в разделе LPC и RPC Handles and OpenCluster.
Функция ClusterResourceControl является одной из функций кода элемента управления. Дополнительные сведения о кодах элементов управления и функциях кода элементов управления см. в разделе Использование кодов элементов управления.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Ни одна версия не поддерживается |
| Минимальная версия сервера | Windows Server 2016 |
| Целевая платформа | Windows |
| Header | clusapi.h |
| Библиотека | ClusAPI.lib |
| DLL | ClusAPI.dll |