QOCINFO structure (sensapi.h)

The QOCINFO structure is returned by the IsDestinationReachable function and provides Quality of Connection information to the caller.

Syntax

typedef struct tagQOCINFO {
  DWORD dwSize;
  DWORD dwFlags;
  DWORD dwInSpeed;
  DWORD dwOutSpeed;
} QOCINFO, *LPQOCINFO;

Members

dwSize

Upon calling IsDestinationReachable, the caller must specify the size of the QOCINFO structure being provided to the function using dwSize. The size should be specified in bytes. Upon return from IsDestinationReachable, dwSize contains the size of the provided structure in bytes.

dwFlags

Provides information on the type of network connection available. The following table lists the possible values.

Flag Meaning
NETWORK_ALIVE_LAN
0x00000001
The computer has one or more active LAN cards.
NETWORK_ALIVE_WAN
0x00000002
The computer has one or more active RAS connections.
NETWORK_ALIVE_AOL
0x00000004
This flag is not supported.

dwInSpeed

Speed of data coming in from the destination in bytes per second.

dwOutSpeed

Speed of data sent to the destination in bytes per second.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Header sensapi.h

See also

IsDestinationReachable