NETCONNECTINFOSTRUCT-Struktur (winnetwk.h)

Die NETCONNECTINFOSTRUCT-Struktur enthält Informationen zur Leistung eines Netzwerks. Sie wird von der NPGetConnectionPerformance-Funktion verwendet.

Syntax

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

Member

cbStructure

Die Größe der NETCONNECTINFOSTRUCT-Struktur in Bytes. Dieser wird vom Aufrufer ausgefüllt, um die Größe der übergebenen Struktur anzugeben. Der Netzwerkanbieter sollte dieses Feld unverändert lassen und kann davon ausgehen, dass die Struktur groß genug ist, um alle Felder bis und einschließlich dwOptDataSize zu enthalten.

dwFlags

Dies ist eine Bitmaske, die mindestens eins der folgenden Flags aufweisen kann.

Wert	Bedeutung
WNCON_FORNETCARD	Wenn festgelegt, sind die zurückgegebenen Informationen für die Leistung der für die Verbindung verwendeten Netcard bestimmt. Diese Informationen werden zurückgegeben, wenn keine Informationen zur tatsächlichen Verbindung verfügbar sind. Wenn nicht festgelegt, werden die zurückgegebenen Informationen für die aktuelle Verbindung mit der Ressource verwendet, wobei alle Routingeinbußen berücksichtigt werden.
WNCON_NOTROUTED	Wenn festgelegt, wird die Verbindung nicht als weitergeleitet behandelt. Anders ausgedrückt: Das Routing wird bei der Schätzung der Leistung nicht berücksichtigt. Dies bedeutet, dass die tatsächliche Leistung viel geringer sein kann als die zurückgegebenen Informationen. Wenn nicht festgelegt, wird die Verbindung möglicherweise über Router ausgeführt, die die Leistung einschränken.
WNCON_SLOWLINK	Wenn festgelegt, ist die Verbindung zu einem bestimmten Zeitpunkt bekannt, dass sie über ein Medium verfügt, das normalerweise langsam ist (z. B. ein Modem, das eine normale Telefonleitung verwendet). Anbieter, die einen Wert in dwSpeed zurückgeben, müssen dieses Bit nicht festlegen.
WNCON_DYNAMIC	Falls festgelegt, werden einige der zurückgegebenen Informationen dynamisch neu berechnet. Wenn dies der Fall ist, gibt das erneute Ausführen dieser Anforderung für die Verbindung möglicherweise andere, aktuellere Informationen zurück.

dwSpeed

Die Geschwindigkeit der Medien zur Netzwerkressource in Einheiten von 100 Bps. Beispielsweise gibt ein 1.200-Baudpunkt-Zu-Punkt-Link 12 zurück.

dwDelay

Die Verzögerung, die das Netzwerk beim Senden von Informationen in Millisekunden verursacht. Mit anderen Worten, die Zeit zwischen dem Senden von Daten durch das Netzwerk und dem Zeitpunkt, zu dem sie empfangen werden. Dies ist zusätzlich zu jeder Latenz, die in die Berechnung von dwSpeed integriert wurde, sodass der zurückgegebene Wert null für den Zugriff auf die meisten Ressourcen ist.

dwOptDataSize

Eine Empfehlung für die Größe der Daten in Bytes, die am effizientesten über das Netzwerk gesendet wird, wenn eine Anwendung eine einzelne Anforderung an die Netzwerkressource sendet. Für eine Datenträgernetzwerkressource kann dieser Wert beispielsweise 2048 oder 512 sein, wenn ein Datenblock geschrieben wird.

Anforderungen

Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	winnetwk.h