Funzione GetClusterNetInterface (clusapi.h)

Articolo
02/26/2024

Restituisce il nome dell'interfaccia di un nodo a una rete in un cluster. Il tipo PCLUSAPI_GET_CLUSTER_NET_INTERFACE definisce un puntatore a questa funzione.

Sintassi

DWORD GetClusterNetInterface(
  [in]      HCLUSTER hCluster,
  [in]      LPCWSTR  lpszNodeName,
  [in]      LPCWSTR  lpszNetworkName,
  [out]     LPWSTR   lpszInterfaceName,
  [in, out] LPDWORD  lpcchInterfaceName
);

Parametri

[in] hCluster

Gestire in un cluster.

[in] lpszNodeName

Puntatore a una stringa Unicode con terminazione Null contenente il nome del nodo nel cluster.

[in] lpszNetworkName

Puntatore a una stringa Unicode con terminazione Null contenente il nome della rete.

[out] lpszInterfaceName

Puntatore a un buffer di output contenente il nome dell'interfaccia di rete.

[in, out] lpcchInterfaceName

Puntatore alla dimensione del buffer lpszInterfaceName come numero di caratteri. In input, specificare il numero massimo di caratteri che il buffer può contenere, incluso il valore NULL di terminazione. Nell'output specifica il numero di caratteri nel nome risultante, escluso il valore NULL di terminazione.

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 uno dei valori possibili.

Codice restituito	Descrizione
ERROR_MORE_DATA	Il buffer a cui punta lpszInterfaceName non è sufficientemente grande da contenere il risultato. Il parametro lpcchInterfaceName restituisce il numero di caratteri nel risultato, escluso il valore NULL di terminazione.

Commenti

Si noti che lpcchInterfaceName fa riferimento a un conteggio di caratteri e non a un conteggio di byte e che le dimensioni restituite non includono il valore NULL di terminazione nel conteggio. Per altre informazioni sul ridimensionamento dei buffer, vedere Convenzioni delle dimensioni dei dati.

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

Condividi tramite