NETCONNECTINFOSTRUCT

The NETCONNECTINFOSTRUCT structure contains information about the expected performance of a connection used to access a network resource. In the dwSpeed, dwDelay or dwOptDataSize members, a value of zero means that no information is available. In the dwSpeed or dwDelay member, a value of one means that the actual value is greater than can be represented in the unit.

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

Members

cbStructure

The size, in bytes, of the NETCONNECTINFOSTRUCT structure. This value is supplied by the caller to indicate the size of the structure.

dwFlags

A bit mask. This member can be one or more of the following flags.

Value	Meaning
WNCON_FORNETCARD	If this flag is set, information is being returned for the performance of the network card, in the absence of information about the actual connection. 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	If set, the connection is not being routed. If the 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	If the flag is set, the connection is over a medium that is typically slow (for example, over a modem using a normal quality phone line). The WNCON_SLOWLINK bit may not be set if the dwSpeed member is set to a non-zero value.
WNCON_DYNAMIC	If the flag is set, some of the information being returned is dynamically recalculated, so reissuing this request may return different or more current information.

dwSpeed

The speed of the media to the network resource in units of 100 bits per second (bps) For example, a 1200 baud point-to-point link returns 12.

dwDelay

The one-way delay introduced by the network when sending information (that is, the time between when data starts being sent and the time that it starts being received), in milliseconds. This delay is additional to any latency that was incorporated into the calculation of dwSpeed, so the value returned will be zero for accessing most resources.

dwOptDataSize

A recommendation for the size of data, in bytes, that is most efficiently sent through the network when an application makes a single request to the network resource. For example, for a disk network resource, this value might be 2048 or 512 when writing a block of data

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in winnetwk.h.

See Also

Networking (Net) Overview, Net Structures, MultinetGetConnectionPerformance, NetUserAdd