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.
[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, tel qu’une des valeurs suivantes.
Code de retour | Description |
---|---|
|
La ressource réseau ne fournit pas ces informations. |
|
Le membre lpLocalName de la structure NETRESOURCE pointée vers 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. |
|
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. |
|
L’appareil local spécifié par le membre lpLocalName n’est pas valide. |
|
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 était NULL et que le membre lpRemoteName de la structure NETRESOURCE pointée vers laquelle l’objet lpNetResource était également ou NULL ou n’a pu être reconnu par aucun réseau. |
|
Tentative d’accès à une adresse non valide. Cette erreur est retournée si les paramètres lpNetResource ou lpNetConnectInfoStruct étaient NULL. |
|
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. |
|
Le réseau n'est pas disponible. |
|
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 ne peut être utilisée que 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 pointée vers 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 comme un 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.
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 |