typedef struct _NETCONNECTINFOSTRUCT {
DWORD cbStructure;
DWORD dwFlags;
DWORD dwSpeed;
DWORD dwDelay;
DWORD dwOptDataSize;
} NETCONNECTINFOSTRUCT. *LPNETCONNECTINFOSTRUCT;
cbStructure
The size of the NETCONNECTINFOSTRUCT structure in bytes. This is filled in by the caller to indicate the size of the structure passed in. The NP should leave this field unchanged, and can assume that the structure is large enough to contain all fields up to and including dwOptDataSize.
dwFlags
This is a bit mask, which may have any of the following bits set:
WNCON_FORNETCARD | If set, information is being returned for the performance of the network card being used for the connection, in the absence of having information about the actual connection. If clear, information is being returned for the current connection with the resource, with any routing degradation being taken into consideration. |
WNCON_NOTROUTED | If clear, 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. If WNCON_NOTROUTED is set, the connection is not being routed. |
WNCON_SLOWLINK | If set, the connection is known at some point to be over a medium that is typically slow (such as a modem using a normal quality phone line). Providers that return a value in dwSpeed do not have to set this bit. |
WNCON_DYNAMIC | If set, some of the information being returned is being dynamically recalculated, and reissuing this request upon the connection may return different, more current, information. |
dwSpeed
The speed of the media to the network resource in units of 100 bps (for example, a 1,200 baud point to point link returns 12).
dwDelay
The delay introduced by the network when sending information (the time between starting sending data and the time that it starts being received) in units of a millisecond. This is in addition to any latency that was incorporated into the calculation of dwSpeed, so the value returned will be 0 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.