Funzione GetClusterNetworkId (clusapi.h)

Articolo
03/13/2024

Restituisce l'identificatore di una rete. Il tipo PCLUSAPI_GET_CLUSTER_NETWORK_ID definisce un puntatore a questa funzione.

Sintassi

DWORD GetClusterNetworkId(
  [in]      HNETWORK hNetwork,
  [out]     LPWSTR   lpszNetworkId,
  [in, out] LPDWORD  lpcchName
);

Parametri

[in] hNetwork

Gestire in una rete.

[out] lpszNetworkId

Puntatore all'identificatore della rete associata a hNetwork, incluso il carattere di terminazione Null.

[in, out] lpcchName

Puntatore alla dimensione del buffer lpszNetworkID 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 lpszNetworkID non è sufficientemente grande da contenere il risultato. Il parametro lpcchNetworkID restituisce il numero di caratteri nel risultato, escluso il valore NULL di terminazione.

Commenti

Si noti che lpcchNetworkID 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

OpenClusterNetwork

Condividi tramite