Función GetClusterResourceState (clusapi.h)
Devuelve el estado actual de un recurso. El tipo PCLUSAPI_GET_CLUSTER_RESOURCE_STATE define un puntero a esta función.
Sintaxis
CLUSTER_RESOURCE_STATE GetClusterResourceState(
[in] HRESOURCE hResource,
[out, optional] LPWSTR lpszNodeName,
[in, out, optional] LPDWORD lpcchNodeName,
[out, optional] LPWSTR lpszGroupName,
[in, out, optional] LPDWORD lpcchGroupName
);
Parámetros
[in] hResource
Control que especifica el recurso para el que se debe devolver la información de estado.
[out, optional] lpszNodeName
Puntero a un búfer que recibe el nombre del nodo propietario actual del recurso especificado como una cadena Unicode terminada en NULL. Pase NULL si el nombre del nodo no es necesario.
[in, out, optional] lpcchNodeName
Puntero al tamaño del búfer lpszNodeName como recuento de caracteres. Este puntero no puede ser NULL a menos que lpszNodeName también sea NULL. En la entrada, especifica el número máximo de caracteres que puede contener el búfer, incluido el valor NULL de terminación. En la salida, especifica el número de caracteres en el nombre resultante, excepto el valor NULL de terminación.
[out, optional] lpszGroupName
Puntero a un búfer que recibe el nombre del grupo que contiene el recurso especificado. El nombre se devuelve como una cadena Unicode terminada en NULL. Pase NULL si el nombre del grupo no es necesario.
[in, out, optional] lpcchGroupName
Puntero al tamaño del búfer lpszGroupName como recuento de caracteres. Este puntero no puede ser NULL a menos que lpszNodeName también sea NULL. En la entrada, especifica el número máximo de caracteres que puede contener el búfer, incluido el valor NULL de terminación. En la salida, especifica el número de caracteres en el nombre resultante, excepto el valor NULL de terminación.
Valor devuelto
GetClusterResourceState devuelve el estado actual del recurso enumerado desde la enumeración CLUSTER_RESOURCE_STATE , que se puede representar mediante uno de los valores siguientes.
| Código o valor devuelto | Descripción |
|---|---|
|
El recurso está realizando la inicialización. |
|
El recurso está operativo y funciona normalmente. |
|
El recurso no está operativo. Este valor se devolverá si el recurso notificó un estado de ClusterResourceOffline (3) o ClusterResourceCannotComeOnlineOnThisNode (127). |
|
Error en el recurso. Este valor se devolverá si el recurso notificó un estado de ClusterResourceFailed (4) o ClusterResourceCannotComeOnlineOnAnyNode (126). |
|
El recurso está en proceso de conectarse o desconectar. |
|
El recurso está en proceso de conectarse. |
|
El recurso está en proceso de desconectar. |
|
La operación no se realizó correctamente. Para obtener más información sobre el error, llame a la función GetLastError. |
Comentarios
No llame a GetClusterResourceState desde ninguna función de punto de entrada dll de recurso. Se puede llamar a GetClusterResourceState de forma segura desde un subproceso de trabajo. Para obtener más información, consulte Llamadas de función para evitar en archivos DLL de recursos.
Ejemplos
Consulte Obtención de estados de objeto para obtener un ejemplo.
Requisitos
| 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 |