Fonction MultinetGetConnectionPerformanceA (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 MultinetGetConnectionPerformanceA(
  [in]  LPNETRESOURCEA         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 est 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 disposer actuellement d’une connexion établie. Par exemple, si la ressource est un fichier sur un serveur de fichiers, le fait que le fichier soit ouvert 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 de retour

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 , par exemple l’une des valeurs suivantes.

Retourner le code	Description
ERROR_NOT_SUPPORTED	La ressource réseau ne fournit pas ces informations.
ERROR_NOT_CONNECTED	Le membre lpLocalName de la structure NETRESOURCE pointée 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 terminé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 par le paramètre lpNetResource a été NULL et le lpRemoteName membre de la structure NETRESOURCE pointée par le lpNetResource était également ou NULL ou n’a pas 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 d’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 vers laquelle il existe actuellement une connexion.

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

Une méthode classique d’utilisation de cette fonction consiste à ouvrir un fichier sur un serveur réseau (ce qui garantit qu’il existe une connexion au fichier), appeler cette fonction et utiliser les résultats pour prendre des décisions sur la gestion des 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.

Note

L’en-tête winnetwk.h définit MultinetGetConnectionPerformance comme 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. Le mélange 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	winnetwk.h
bibliothèque	Mpr.lib
DLL	Mpr.dll

Voir aussi

NETCONNECTINFOSTRUCT

NETRESOURCE

Vue d’ensemble mise en réseau Windows (WNet)

fonctions de mise en réseau Windows