NPGetConnectionPerformance, fonction (npapi.h)

Renvoie des informations sur les performances attendues d’une connexion utilisée pour accéder à une ressource réseau. La requête peut uniquement être destinée à 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 de réseau si le fournisseur a une connexion à la ressource réseau. Tous les autres champs de cette structure, à l’exception du champ cbStructure , sont remplis de zéros avant que le MPR passe la demande aux fournisseurs de 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 taux, une valeur de 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.

Spécifications