Méthode INetworkListManager ::GetNetworkConnection (netlistmgr.h)

Article
03/04/2024

La méthode GetNetworkConnection récupère un réseau basé sur un ID de connexion réseau fourni.

Syntaxe

HRESULT GetNetworkConnection(
  [in]          GUID               gdNetworkConnectionId,
  [out, retval] INetworkConnection **ppNetworkConnection
);

Paramètres

[in] gdNetworkConnectionId

GUID qui spécifie l’ID de connexion réseau.

[out, retval] ppNetworkConnection

Pointeur vers un pointeur vers l’objet INetworkConnection associé au gdNetworkConnectionId fourni.

Valeur retournée

Si la méthode aboutit, renvoie S_OK. Sinon, la méthode retourne l’une des valeurs suivantes.

Code de retour	Description
S_FALSE	Le réseau associé à l’ID de connexion réseau spécifié est introuvable.
E_POINTER	Le pointeur passé est NULL.
E_UNEXPECTED	Le GUID spécifié n’est pas valide.

Remarques

Cette méthode peut retourner S_FALSE si une connexion réseau associée à l’ID spécifié a été supprimée. Par exemple, il est possible pour un client de recevoir un événement INetworkConnectionEvents ::NetworkConnectionConnectivityChanged avec un ID de connexion réseau, mais de constater que la connexion réseau a été déconnectée ou même remplacée par le moment où INetworkListManager ::GetNetworkConnection est appelé avec l’ID fourni.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	netlistmgr.h

Voir aussi

INetworkConnection

INetworkListManager

Partager via