Función ClusterResourceTypeControl (clusapi.h)

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

Sintaxis

DWORD ClusterResourceTypeControl(
  [in]            HCLUSTER hCluster,
  [in]            LPCWSTR  lpszResourceTypeName,
  [in, optional]  HNODE    hHostNode,
  [in]            DWORD    dwControlCode,
  [in, optional]  LPVOID   lpInBuffer,
  [in]            DWORD    nInBufferSize,
  [out, optional] LPVOID   lpOutBuffer,
  [in]            DWORD    nOutBufferSize,
  [out, optional] LPDWORD  lpBytesReturned
);

Parámetros

[in] hCluster

Identificador del clúster que contiene el tipo de recurso identificado en lpszResourceTypeName.

[in] lpszResourceTypeName

Puntero a una cadena Unicode terminada en NULL que contiene el nombre del tipo de recurso que se va a ver afectado.

[in, optional] hHostNode

Identificador del nodo que hospeda el tipo de recurso afectado.

[in] dwControlCode

Código de control de tipo de recurso que especifica 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:

• CLUSCTL_RESOURCE_TYPE_ENUM_COMMON_PROPERTIES
• CLUSCTL_RESOURCE_TYPE_ENUM_PRIVATE_PROPERTIES
• CLUSCTL_RESOURCE_TYPE_GET_CHARACTERISTICS
• CLUSCTL_RESOURCE_TYPE_GET_CLASS_INFO
• CLUSCTL_RESOURCE_TYPE_GET_COMMON_PROPERTIES
• CLUSCTL_RESOURCE_TYPE_GET_COMMON_PROPERTY_FMTS
• CLUSCTL_RESOURCE_TYPE_GET_COMMON_RESOURCE_PROPERTY_FMTS
• CLUSCTL_RESOURCE_TYPE_GET_CRYPTO_CHECKPOINTS
• CLUSCTL_RESOURCE_TYPE_GET_FLAGS
• CLUSCTL_RESOURCE_TYPE_GET_PRIVATE_PROPERTIES
• CLUSCTL_RESOURCE_TYPE_GET_PRIVATE_PROPERTY_FMTS
• CLUSCTL_RESOURCE_TYPE_GET_PRIVATE_RESOURCE_PROPERTY_FMTS
• CLUSCTL_RESOURCE_TYPE_GET_REGISTRY_CHECKPOINTS
• CLUSCTL_RESOURCE_TYPE_GET_REQUIRED_DEPENDENCIES
• CLUSCTL_RESOURCE_TYPE_GET_RO_COMMON_PROPERTIES
• CLUSCTL_RESOURCE_TYPE_GET_RO_PRIVATE_PROPERTIES
• CLUSCTL_RESOURCE_TYPE_QUERY_DELETE
• CLUSCTL_RESOURCE_TYPE_SET_COMMON_PROPERTIES
• CLUSCTL_RESOURCE_TYPE_SET_PRIVATE_PROPERTIES
• CLUSCTL_RESOURCE_TYPE_STORAGE_GET_AVAILABLE_DISKS
• CLUSCTL_RESOURCE_TYPE_STORAGE_GET_RESOURCEID
• CLUSCTL_RESOURCE_TYPE_UNKNOWN
• CLUSCTL_RESOURCE_TYPE_VALIDATE_COMMON_PROPERTIES
• CLUSCTL_RESOURCE_TYPE_VALIDATE_PRIVATE_PROPERTIES

[in, optional] lpInBuffer

Puntero al búfer de entrada con información necesaria para la operación, o NULL si no se necesita información.

[in] nInBufferSize

Número de bytes del búfer al que apunta lpInBuffer.

[out, optional] lpOutBuffer

Puntero al búfer de salida con información resultante de la operación, o NULL si no se devolverá nada.

[in] nOutBufferSize

Número de bytes del búfer de salida al que apunta lpOutBuffer o cero si el autor de la llamada no sabe cuántos datos se devolverán.

[out, optional] lpBytesReturned

Puntero al número de bytes del búfer a los que apunta lpOutBuffer que se rellenaron realmente como resultado de la operación. El autor de la llamada puede pasar NULL para lpBytesReturned si ClusterResourceTypeControl no necesita devolver el número de bytes en el búfer de salida.

Valor devuelto

La función devuelve uno de los valores siguientes.

Código devuelto	Descripción
ERROR_SUCCESS	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	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 nOutBufferSize es cero, se puede devolver ERROR_SUCCESS, no ERROR_MORE_DATA.
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 no es confiable.

Comentarios

Cuando ClusterResourceTypeControl devuelve ERROR_MORE_DATA, establezca nOutBufferSize 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.

ClusterResourceTypeControl 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 tipo de recurso