Share via

Función ClusterResourceControl (clusapi.h)

  • Artículo

Inicia una operación que afecta a un recurso. La operación realizada depende del código de control pasado al parámetro dwControlCode .

Sintaxis

DWORD ClusterResourceControl(
  [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
);

Parámetros

[in] hResource

Identificador del recurso que se va a ver afectado.

[in, optional] hHostNode

Identificador opcional del nodo para realizar la operación. Si es NULL, el nodo propietario del recurso identificado por hResource realiza la operación.

[in] dwControlCode

Código de control de recursos, enumerado por la enumeración CLUSCTL_RESOURCE_CODES , especificando la operación que se va a realizar. Para obtener la sintaxis asociada a un código de control, consulte
Control de la arquitectura de código y los temas siguientes:

[in, optional] lpInBuffer

Puntero a un búfer de entrada que contiene información necesaria para la operación o NULL si no se necesita información.

[in] cbInBufferSize

Tamaño asignado (en bytes) del búfer de entrada.

[out, optional] lpOutBuffer

Puntero a un búfer de salida para recibir los datos resultantes de la operación, o NULL si no se devolverán datos.

[in] cbOutBufferSize

Tamaño asignado (en bytes) del búfer de salida.

[out, optional] lpBytesReturned

Devuelve el tamaño real (en bytes) de los datos resultantes de la operación. Si esta información no es necesaria, pase NULL para lpBytesReturned.

Valor devuelto

La función devuelve uno de los valores siguientes.

Código o valor devuelto Descripción
ERROR_SUCCESS
0
 La operación se realizó correctamente. Si la operación requería un búfer de salida, lpBytesReturned (si no es NULL en la entrada) apunta al tamaño real de los datos devueltos en el búfer.
ERROR_MORE_DATA
234 (0xEA)
 El búfer de salida al que apunta lpOutBuffer no era lo suficientemente grande como para contener los datos resultantes de la operación. El parámetro lpBytesReturned (si no es NULL en la entrada) apunta al tamaño necesario para el búfer de salida. Solo las operaciones que requieren un búfer de salida devuelven ERROR_MORE_DATA. Si el parámetro lpOutBuffer es NULL y el parámetro cbOutBufferSize es cero, se puede devolver ERROR_SUCCESS, no ERROR_MORE_DATA.
ERROR_RESOURCE_PROPERTIES_STORED
5024 (0x13A0)
 Solo se aplica a CLUSCTL_RESOURCE_SET_COMMON_PROPERTIES y CLUSCTL_RESOURCE_SET_PRIVATE_PROPERTIES. Indica que las propiedades se almacenaron correctamente, pero aún no se han aplicado al recurso. Las nuevas propiedades surtirán efecto después de que el recurso se desconecte y vuelva a estar en línea.
ERROR_HOST_NODE_NOT_RESOURCE_OWNER
5015 (0x1397)
 El nodo especificado por el parámetro hNode no es el nodo que posee el recurso especificado por hResource.
Código de error del sistema
 La operación no se realizó correctamente. Si la operación requiere un búfer de salida, el valor especificado por lpBytesReturned (si no es NULL en la entrada) no es confiable.

Comentarios

Cuando ClusterResourceControl devuelve ERROR_MORE_DATA, establezca cbOutBufferSize en el número de bytes a los que apunta lpBytesReturned y vuelva a llamar a la función.

No pase los identificadores LPC y RPC a la misma llamada de función. De lo contrario, la llamada generará una excepción RPC y puede tener efectos destructivos adicionales. Para obtener información sobre cómo se crean los identificadores LPC y RPC, consulte LPC y identificadores RPC y OpenCluster.

La función ClusterResourceControl es una de las funciones de código de control. Para obtener más información sobre los códigos de control y las funciones de código de control, vea Usar códigos de control.

Requisitos

Requisito Value
Cliente mínimo compatible No se admite ninguno
Servidor mínimo compatible Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Plataforma de destino Windows
Encabezado clusapi.h
Library ClusAPI.lib
Archivo DLL ClusAPI.dll

Consulte también

OpenCluster

Códigos de control de recursos