Funzione GetClusterResourceState (clusapi.h)

Articolo
03/08/2023

Restituisce lo stato corrente di una risorsa. Il tipo PCLUSAPI_GET_CLUSTER_RESOURCE_STATE definisce un puntatore a questa funzione.

Sintassi

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
);

Parametri

[in] hResource

Handle che specifica la risorsa per cui devono essere restituite le informazioni sullo stato.

[out, optional] lpszNodeName

Puntatore a un buffer che riceve il nome del nodo proprietario corrente della risorsa specificata come stringa Unicode con terminazione NULL. Passare NULL se il nome del nodo non è obbligatorio.

[in, out, optional] lpcchNodeName

Puntatore alla dimensione del buffer lpszNodeName come conteggio dei caratteri. Questo puntatore non può essere NULL a meno che lpszNodeName non sia null. In input specifica il numero massimo di caratteri che il buffer può contenere, incluso il valore NULL terminante. Nell'output specifica il numero di caratteri nel nome risultante, escluse le terminazioni NULL.

[out, optional] lpszGroupName

Puntatore a un buffer che riceve il nome del gruppo che contiene la risorsa specificata. Il nome viene restituito come stringa Unicode con terminazione NULL. Passare NULL se il nome del gruppo non è obbligatorio.

[in, out, optional] lpcchGroupName

Puntatore alla dimensione del buffer lpszGroupName come conteggio dei caratteri. Questo puntatore non può essere NULL a meno che lpszNodeName non sia null. In input specifica il numero massimo di caratteri che il buffer può contenere, incluso il valore NULL terminante. Nell'output specifica il numero di caratteri nel nome risultante, escluse le terminazioni NULL.

Valore restituito

GetClusterResourceState restituisce lo stato corrente della risorsa enumerata dall'enumerazione CLUSTER_RESOURCE_STATE , che può essere rappresentata da uno dei valori seguenti.

Codice/valore restituito	Descrizione
ClusterResourceInitializing 1	La risorsa esegue l'inizializzazione.
ClusterResourceOnline 2	La risorsa è operativa e funzionante normalmente.
ClusterResourceOffline 3	La risorsa non è operativa. Questo valore verrà restituito se la risorsa ha segnalato uno stato di ClusterResourceOffline (3) o ClusterResourceCannotComeOnlineOnThisNode (127).
ClusterResourceFailed 4	La risorsa non è riuscita. Questo valore verrà restituito se la risorsa ha segnalato uno stato di ClusterResourceFailed (4) o ClusterResourceCannotComeOnlineOnAnyNode (126).
ClusterResourcePending 128	La risorsa si trova nel processo di arrivo online o offline.
ClusterResourceOnlinePending 129	La risorsa si trova nel processo di arrivo online.
ClusterResourceOfflinePending 130	La risorsa si trova nel processo di uscita offline.
ClusterResourceStateUnknown -1	L'operazione non ha avuto esito positivo. Per altre informazioni sull'errore, chiamare la funzione GetLastError.

Commenti

Non chiamare GetClusterResourceState da qualsiasi funzione del punto di ingresso dll di risorse. GetClusterResourceState può essere chiamato in modo sicuro da un thread di lavoro. Per altre informazioni, vedere Chiamate di funzione per evitare nelle DLL delle risorse.

Esempio

Per un esempio, vedere Recupero degli stati oggetto .

Requisiti


Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Piattaforma di destinazione	Windows
Intestazione	clusapi.h
Libreria	ClusAPI.lib
DLL	ClusAPI.dll