Partager via


Fonction NPGetConnectionPerformance (npapi.h)

Retourne des informations sur les performances attendues d’une connexion utilisée pour accéder à une ressource réseau. La demande ne peut concerner qu’une ressource réseau actuellement connectée.

Syntaxe

DWORD NPGetConnectionPerformance(
  [in]  LPCWSTR                lpRemoteName,
  [out] LPNETCONNECTINFOSTRUCT lpNetConnectInfo
);

Paramètres

[in] lpRemoteName

Pointeur vers le nom local ou le nom distant d’une ressource connectée.

[out] lpNetConnectInfo

Pointeur vers une structure NETCONNECTINFOSTRUCT , qui est renseignée par le fournisseur réseau si le fournisseur dispose d’une connexion à la ressource réseau. Tous les autres champs de cette structure, à l’exception du champ cbStructure , sont remplis avec des zéros avant que le MPR ne transmette la demande aux fournisseurs réseau. Par conséquent, le fournisseur doit écrire uniquement dans les champs pour lesquels il dispose d’informations disponibles. En outre, pour les valeurs de débit, la valeur 1 signifie que les performances sont meilleures que celles qui peuvent être représentées dans l’unité.

Les informations retournées peuvent être une estimation. Si le réseau ne peut pas obtenir d’informations sur la ressource sur le réseau, il peut retourner des informations sur la carte réseau et ses performances associées, puis définir le champ dwFlags en conséquence.

Valeur retournée

Si la fonction réussit, elle doit retourner WN_SUCCESS. Sinon, il doit retourner un code d’erreur, qui peut être l’un des éléments suivants.

Code de retour Description
WN_NOT_CONNECTED
lpRemoteName n’est pas une ressource réseau connectée.
WN_NO_NETWORK
Le réseau n’est pas présent.

Spécifications

   
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête npapi.h