Structure NETCONNECTINFOSTRUCT (winnetwk.h)

La structure NETCONNECTINFOSTRUCT contient des informations sur les performances d’un réseau. Il est utilisé par la fonction NPGetConnectionPerformance .

Syntaxe

typedef struct _NETCONNECTINFOSTRUCT {
  DWORD cbStructure;
  DWORD dwFlags;
  DWORD dwSpeed;
  DWORD dwDelay;
  DWORD dwOptDataSize;
} NETCONNECTINFOSTRUCT, *LPNETCONNECTINFOSTRUCT;

Membres

cbStructure

Taille de la structure NETCONNECTINFOSTRUCT , en octets. Celui-ci est renseigné par l’appelant pour indiquer la taille de la structure transmise. Le fournisseur de réseau doit laisser ce champ inchangé et peut supposer que la structure est suffisamment grande pour contenir tous les champs jusqu’à et y compris dwOptDataSize.

dwFlags

Il s’agit d’un masque de bits qui peut avoir un ou plusieurs des indicateurs suivants.

Valeur	Signification
WNCON_FORNETCARD	Si elle est définie, les informations retournées concernent les performances de la carte net utilisée pour la connexion. Ces informations sont retournées si des informations sur la connexion réelle ne sont pas disponibles. Si elles ne sont pas définies, les informations retournées concernent la connexion actuelle avec la ressource, en tenant compte de toute dégradation du routage.
WNCON_NOTROUTED	Si elle est définie, la connexion n’est pas traitée comme étant routée. En d’autres termes, le routage n’est pas pris en compte lors de l’estimation des performances. Cela signifie que les performances réelles peuvent être bien inférieures aux informations retournées. Si elle n’est pas définie, la connexion peut passer par des routeurs qui limitent les performances.
WNCON_SLOWLINK	Si elle est définie, la connexion est connue à un moment donné pour être sur un support généralement lent (par exemple, un modem utilisant une ligne téléphonique de qualité normale). Les fournisseurs qui retournent une valeur dans dwSpeed n’ont pas besoin de définir ce bit.
WNCON_DYNAMIC	Si elle est définie, certaines des informations retournées sont recalculées dynamiquement. Si tel est le cas, la réédition de cette demande sur la connexion peut renvoyer des informations différentes et plus actuelles.

dwSpeed

Vitesse du média à la ressource réseau en unités de 100 pbs. Par exemple, un lien point à point de 1 200 bauds retourne 12.

dwDelay

Délai introduit par le réseau lors de l’envoi d’informations, en millisecondes. En d’autres termes, le délai entre le moment où le réseau commence à envoyer des données et le moment où elles sont reçues. Cela s’ajoute à toute latence qui a été incorporée dans le calcul de dwSpeed, de sorte que la valeur retournée sera égale à zéro pour accéder à la plupart des ressources.

dwOptDataSize

Recommandation concernant la taille des données, en octets, qui sont envoyées plus efficacement via le réseau lorsqu’une application effectue une requête unique à la ressource réseau. Par exemple, pour une ressource réseau de disque, cette valeur peut être 2048 ou 512 lors de l’écriture d’un bloc de données.

Configuration requise

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