Condividi tramite

Funzione ClusterResourceControl (clusapi.h)

  • Articolo

Avvia un'operazione che influisce su una risorsa. L'operazione eseguita dipende dal codice di controllo passato al parametro dwControlCode .

Sintassi

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

Parametri

[in] hResource

Gestire la risorsa da interessare.

[in, optional] hHostNode

Handle facoltativo nel nodo per eseguire l'operazione. Se NULL, il nodo proprietario della risorsa identificata da hResource esegue l'operazione.

[in] dwControlCode

Codice di controllo delle risorse, enumerato dall'enumerazione CLUSCTL_RESOURCE_CODES , specificando l'operazione da eseguire. Per la sintassi associata a un codice di controllo, fare riferimento a
Architettura del codice di controllo e gli argomenti seguenti:

[in, optional] lpInBuffer

Puntatore a un buffer di input contenente informazioni necessarie per l'operazione o NULL se non sono necessarie informazioni.

[in] cbInBufferSize

Dimensione allocata (in byte) del buffer di input.

[out, optional] lpOutBuffer

Puntatore a un buffer di output per ricevere i dati risultanti dall'operazione o NULL se non verranno restituiti dati.

[in] cbOutBufferSize

Dimensione allocata (in byte) del buffer di output.

[out, optional] lpBytesReturned

Restituisce le dimensioni effettive (in byte) dei dati risultanti dall'operazione. Se queste informazioni non sono necessarie, passare NULL per lpBytesReturned.

Valore restituito

La funzione restituisce uno dei valori seguenti.

Codice/valore restituito Descrizione
ERROR_SUCCESS
0
 L'operazione è stata completata. Se l'operazione richiede un buffer di output, lpBytesReturned (se non NULL in input) punta alle dimensioni effettive dei dati restituiti nel buffer.
ERROR_MORE_DATA
234 (0xEA)
 Il buffer di output a cui punta lpOutBuffer non è sufficiente per contenere i dati risultanti dall'operazione. Il parametro lpBytesReturned (se non NULL nell'input) punta alle dimensioni necessarie per il buffer di output. Solo le operazioni che richiedono un buffer di output restituiscono ERROR_MORE_DATA. Se il parametro lpOutBuffer è NULL e il parametro cbOutBufferSize è zero, è possibile che venga restituito ERROR_SUCCESS, non ERROR_MORE_DATA.
ERROR_RESOURCE_PROPERTIES_STORED
5024 (0x13A0)
 Si applica solo a CLUSCTL_RESOURCE_SET_COMMON_PROPERTIES e CLUSCTL_RESOURCE_SET_PRIVATE_PROPERTIES. Indica che le proprietà sono state archiviate correttamente ma non sono state ancora applicate alla risorsa. Le nuove proprietà avranno effetto dopo che la risorsa viene portata offline e nuovamente online.
ERROR_HOST_NODE_NOT_RESOURCE_OWNER
5015 (0x1397)
 Il nodo specificato dal parametro hNode non è il nodo proprietario della risorsa specificata da hResource.
Codice di errore di sistema
 L'operazione non è riuscita. Se l'operazione richiede un buffer di output, il valore specificato da lpBytesReturned (se non NULL in input) non è affidabile.

Commenti

Quando ClusterResourceControl restituisce ERROR_MORE_DATA, impostare cbOutBufferSize sul numero di byte a cui punta lpBytesReturned e chiamare di nuovo la funzione.

Non passare handle LPC e RPC alla stessa chiamata di funzione. In caso contrario, la chiamata genererà un'eccezione RPC e può avere effetti distruttivi aggiuntivi. Per informazioni sulla creazione degli handle LPC e RPC, vedere Handle LPC e RPC e OpenCluster.

La funzione ClusterResourceControl è una delle funzioni del codice di controllo. Per altre informazioni sui codici di controllo e sulle funzioni del codice di controllo, vedere Uso dei codici di controllo.

Requisiti

Requisito Valore
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

Vedi anche

OpenCluster

Codici di controllo delle risorse