Fonction MultinetGetConnectionPerformanceW (winnetwk.h)

La fonction MultinetGetConnectionPerformance retourne des informations sur les performances attendues d’une connexion utilisée pour accéder à une ressource réseau.

Syntaxe

DWORD MultinetGetConnectionPerformanceW(
  [in]  LPNETRESOURCEW         lpNetResource,
  [out] LPNETCONNECTINFOSTRUCT lpNetConnectInfoStruct
);

Paramètres

[in] lpNetResource

Pointeur vers une structure NETRESOURCE qui spécifie la ressource réseau. Les membres suivants ont des significations spécifiques dans ce contexte.

Membre	Signification
lpLocalName	Pointeur vers une mémoire tampon qui spécifie un appareil local, tel que « F: » ou « LPT1 », qui est redirigé vers une ressource réseau à interroger. Si ce membre a la valeur NULL ou une chaîne vide, la ressource réseau est spécifiée dans le membre lpRemoteName . Si cet indicateur spécifie un appareil local, lpRemoteName est ignoré.
lpRemoteName	Pointeur vers une ressource réseau à interroger. La ressource doit actuellement avoir une connexion établie. Par exemple, si la ressource est un fichier sur un serveur de fichiers, le fait d’ouvrir le fichier garantit la connexion.
lpProvider	Généralement défini sur NULL, mais peut être un pointeur vers le propriétaire (fournisseur) de la ressource si le réseau sur lequel réside la ressource est connu. Si le membre lpProvider n’est pas NULL, le système tente de retourner des informations uniquement sur le réseau nommé.

[out] lpNetConnectInfoStruct

Pointeur vers la structure NETCONNECTINFOSTRUCT qui reçoit les données.

Valeur retournée

Si la fonction réussit, la valeur de retour est NO_ERROR.

Si la fonction échoue, la valeur de retour est un code d’erreur système, comme l’une des valeurs suivantes.

Code de retour	Description
ERROR_NOT_SUPPORTED	La ressource réseau ne fournit pas ces informations.
ERROR_NOT_CONNECTED	Le membre lpLocalName de la structure NETRESOURCE pointé vers par le paramètre lpNetResource ne spécifie pas d’appareil redirigé, ou le membre lpRemoteName ne spécifie pas le nom d’une ressource actuellement connectée.
ERROR_NO_NET_OR_BAD_PATH	L’opération n’a pas pu être effectuée, soit parce qu’un composant réseau n’est pas démarré, soit parce que le nom de ressource spécifié n’est pas reconnu.
ERROR_BAD_DEVICE	L’appareil local spécifié par le membre lpLocalName n’est pas valide.
ERROR_BAD_NET_NAME	Le nom du réseau est introuvable. Cette erreur est retournée si le membre lpLocalName de la structure NETRESOURCE pointée vers par le paramètre lpNetResource était NULL et que le membre lpRemoteName de la structure NETRESOURCE pointé vers l’objet lpNetResource était également ou NULL ou n’a pu être reconnu par n’importe quel réseau.
ERROR_INVALID_ADDRESS	Tentative d’accès à une adresse non valide. Cette erreur est retournée si les paramètres lpNetResource ou lpNetConnectInfoStruct étaient NULL.
ERROR_INVALID_PARAMETER	Un paramètre incorrect a été passé. Cette erreur est retournée si le paramètre lpNetConnectInfoStruct ne pointe pas vers une structure NETCONNECTINFOSTRUCT dans laquelle le membre cbStructure est rempli avec la taille de structure appropriée.
ERROR_NO_NETWORK	Le réseau n'est pas disponible.
ERROR_EXTENDED_ERROR	Une erreur spécifique au réseau s’est produite. Pour obtenir une description de l’erreur, appelez WNetGetLastError.

Remarques

La fonction MultinetGetConnectionPerformance retourne les informations dans une structure NETCONNECTINFOSTRUCT .

Les informations retournées par la fonction MultinetGetConnectionPerformance sont une estimation uniquement. Le trafic réseau et le routage peuvent affecter la précision des résultats retournés.

Notez que la fonction MultinetGetConnectionPerformance peut être utilisée uniquement pour demander des informations pour un appareil local redirigé vers une ressource réseau ou pour une ressource réseau à laquelle il existe actuellement une connexion.

Si un chemin UNC est spécifié dans le membre lpRemoteName de la structure NETRESOURCE vers laquelle pointe le paramètre lpNetResource , le membre lpRemoteName doit être un nom de répertoire, et non un nom de fichier.

Une façon classique d’utiliser cette fonction consiste à ouvrir un fichier sur un serveur réseau (ce qui garantirait qu’il existe une connexion au fichier), à appeler cette fonction et à utiliser les résultats pour prendre des décisions sur la façon de gérer les E/S de fichier. Par exemple, vous pouvez décider de lire l’intégralité du fichier dans un fichier temporaire sur le client ou d’accéder directement au fichier sur le serveur.

Notes

L’en-tête winnetwk.h définit MultinetGetConnectionPerformance en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winnetwk.h
Bibliothèque	Mpr.lib
DLL	Mpr.dll

Voir aussi

NETCONNECTINFOSTRUCT

NETRESOURCE

Vue d’ensemble de Windows Networking (WNet)

Fonctions de mise en réseau Windows