Condividi tramite

Funzione ClusterGroupSetControl (clusapi.h)

  • Articolo

Avvia un'operazione che influisce su un set di gruppi.

L'operazione eseguita dipende dal codice di controllo passato al parametro dwControlCode .

Sintassi

DWORD ClusterGroupSetControl(
  [in]            HGROUPSET hGroupSet,
  [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] hGroupSet

Gestire l'oggetto groupset da interessare.

[in, optional] hHostNode

Se non NULL, gestire il nodo per eseguire l'operazione rappresentata dal codice di controllo. Se NULL, il nodo proprietario del grupposet esegue l'operazione. Se si specifica hHostNode , è facoltativo.

[in] dwControlCode

Codice di controllo raccolta che specifica 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 restituito Descrizione
ERROR_SUCCESS
 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
 Il buffer di output a cui fa riferimento lpOutBuffer non era abbastanza grande per contenere i dati risultanti dall'operazione. Il parametro lpBytesReturned (se non NULL in input) punta alle dimensioni necessarie per il buffer di output. Solo le operazioni che richiedono una restituzione del buffer di output ERROR_MORE_DATA. Se il parametro lpOutBuffer è NULL e il parametro nOutBufferSize è zero, ERROR_SUCCESS può essere restituito, non ERROR_MORE_DATA.
Codice errore di sistema
 L'operazione non ha avuto esito positivo. Se l'operazione richiede un buffer di output, il valore specificato da lpBytesReturned (se non NULL in input) non è attendibile.

Requisiti

Requisito Valore
Client minimo supportato Nessuno supportato
Server minimo supportato Windows Server 2016
Piattaforma di destinazione Windows
Intestazione clusapi.h
Libreria ClusAPI.lib
DLL ClusAPI.dll