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.
- 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 |
|
See also