Funzione OnlineClusterResourceEx (clusapi.h)
Porta online una risorsa offline o non riuscita.
Sintassi
DWORD OnlineClusterResourceEx(
[in] HRESOURCE hResource,
[in] DWORD dwOnlineFlags,
[in, optional] PBYTE lpInBuffer,
[in] DWORD cbInBufferSize
);
Parametri
[in] hResource
Handle per la risorsa da portare online.
[in] dwOnlineFlags
Flag che specifica le impostazioni per la risorsa da portare online.
CLUSAPI_GROUP_ONLINE_IGNORE_RESOURCE_STATUS (0x00000001)
Il server deve ignorare la modalità bloccata per la risorsa.
CLUSAPI_RESOURCE_ONLINE_DO_NOT_UPDATE_PERSISTENT_STATE (0x00000002)
Non aggiornare lo stato permanente della risorsa.
CLUSAPI_RESOURCE_ONLINE_NECESSARY_FOR_QUORUM (0x00000004)
La risorsa deve essere portata online per mantenere un quorum.
CLUSAPI_RESOURCE_ONLINE_BEST_POSSIBLE_NODE (0x00000008)
Il servizio cluster consiste nel determinare il nodo che ospiterà la risorsa quando viene portato online.
Windows Server 2012 R2 e Windows Server 2012: questo valore non è supportato prima della Windows Server 2016.
0
Il server non deve ignorare la modalità bloccata per la risorsa.
[in, optional] lpInBuffer
Puntatore al buffer di input che riceve le istruzioni per l'operazione. Il parametro lpInBuffer viene formattato come elenco di proprietà.
[in] cbInBufferSize
Dimensioni di lpInBuffer, in byte.
Valore restituito
Se l'operazione ha esito positivo, la funzione restituisce ERROR_SUCCESS.
Se l'operazione non riesce, la funzione restituisce un codice di errore di sistema. Di seguito è riportato un possibile codice di errore.
| Codice restituito | Descrizione |
|---|---|
|
La risorsa o una delle risorse da cui dipende ha restituito ERROR_IO_PENDING dalla relativa funzione punto di ingresso online . |
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Nessuno supportato |
| Server minimo supportato | Windows Server 2012 |
| Piattaforma di destinazione | Windows |
| Intestazione | clusapi.h |
| Libreria | ClusAPI.lib |
| DLL | ClusAPI.dll |