NETCONNECTINFOSTRUCT structure

The NETCONNECTINFOSTRUCT structure contains information about the expected performance of a connection used to access a network resource. The information is returned by the MultinetGetConnectionPerformance function.

Syntax


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

Members

cbStructure

Type: DWORD

The size, in bytes, of the NETCONNECTINFOSTRUCT structure. The caller must supply this value.

dwFlags

Type: DWORD

A set of bit flags describing the connection. This member can be one or more of the following values.

ValueMeaning
WNCON_FORNETCARD

In the absence of information about the actual connection, the information returned applies to the performance of the network card.

If this flag is not set, information is being returned for the current connection with the resource, with any routing degradation taken into consideration.

WNCON_NOTROUTED

The connection is not being routed.

If this flag is not set, the connection may be going through routers that limit performance. Consequently, if WNCON_FORNETCARD is set, actual performance may be much less than the information returned.

WNCON_SLOWLINK

The connection is over a medium that is typically slow (for example, over a modem using a normal quality phone line). You should not set the WNCON_SLOWLINK bit if the dwSpeed member is set to a nonzero value.

WNCON_DYNAMIC

Some of the information returned is calculated dynamically, so reissuing this request may return different (and more current) information.

 

dwSpeed

Type: DWORD

Speed of the media to the network resource, in 100 bits-per-second (bps).

For example, a 1200 baud point-to-point link returns 12. A value of zero indicates that no information is available. A value of one indicates that the actual value is greater than the maximum that can be represented by the member.

dwDelay

Type: DWORD

One-way delay time that the network introduces when sending information, in milliseconds. (The delay is the time between when the network begins sending data and the time that the data starts being received.) This delay is in addition to any latency incorporated in the calculation of the dwSpeed member; therefore the value of this member is zero for most resources.

A value of zero indicates that no information is available. A value of one indicates that the actual value is greater than the maximum that can be represented by the member.

dwOptDataSize

Type: DWORD

Size of data that an application should use when making a single request to the network resource, in bytes.

For example, for a disk network resource, this value might be 2048 or 512 when writing a block of data. A value of zero indicates that no information is available.

Remarks

The NETCONNECTINFOSTRUCT structure is used in the MultinetGetConnectionPerformance function.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Winnetwk.h

See also

Windows Networking (WNet) Overview
Windows Networking Structures
MultinetGetConnectionPerformance

 

 

Community Additions

ADD
Show: