Condividi tramite

Funzione ClusterNetInterfaceEnum (clusapi.h)

  • Articolo

Enumera le interfacce di rete installate in un cluster, restituendo un nome a ogni chiamata.

Sintassi

DWORD ClusterNetInterfaceEnum(
  [in]      HNETINTERFACEENUM hNetInterfaceEnum,
  [in]      DWORD             dwIndex,
  [out]     LPWSTR            lpszName,
  [in, out] LPDWORD           lpcchName
);

Parametri

[in] hNetInterfaceEnum

Handle a un oggetto di enumerazione esistente originariamente restituito dalla funzione ClusterNetInterfaceOpenEnum .

[in] dwIndex

Indice usato per identificare la voce da enumerare. Questo parametro deve essere zero per la prima chiamata e quindi incrementato per ogni chiamata successiva.

[out] lpszName

Puntatore a una stringa Unicode con terminazione null contenente il nome dell'oggetto restituito.

[in, out] lpcchName

Puntatore alle dimensioni, in caratteri, del buffer lpszName . In input specificare il numero massimo di caratteri che il buffer può contenere, incluso il valore NULL di terminazione. Nell'output indica il numero di caratteri nel nome risultante, escluso il valore NULL di terminazione.

Valore restituito

La funzione restituisce uno dei valori seguenti.

Codice/valore restituito Descrizione
ERROR_SUCCESS
0
 Operazione riuscita.
ERROR_NO_MORE_ITEMS
259 (0x103)
 Dati disponibili esauriti. Questo valore viene restituito se non sono presenti più oggetti da restituire.
ERROR_MORE_DATA
234 (0xEA)
 sono disponibili più dati. Questo valore viene restituito se il buffer puntato da lpszName non è abbastanza grande per contenere il risultato. Il parametro lpcchName restituisce il numero di caratteri nel risultato, escluso il valore NULL terminante.

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