IPX_ADDRESS_DATA

The IPX_ADDRESS_DATA structure provides information about a specific adapter to which IPX is bound. Used in conjunction with getsockopt function calls that specify IPX_ADDRESS in the optname parameter.

typedef struct _IPX_ADDRESS_DATA {
    INT   adapternum;  /* input: 0-based adapter number */
    UCHAR netnum[4];   /* output: IPX network number */
    UCHAR nodenum[6];  /* output: IPX node address */
    BOOLEAN wan;       /* output: TRUE = adapter is on a wan link */
    BOOLEAN status;    /* output: TRUE = wan link is up (or adapter is not wan) */
    INT   maxpkt;      /* output: max packet size, not including IPX header */
    ULONG linkspeed;   /* output: link speed in 100 bytes/sec (i.e. 96 == 9600 bps) */
} IPX_ADDRESS_DATA, *PIPX_ADDRESS_DATA;

Members

adapternum

[in] Adapter number.

netnum

[out] IPX network number for the associated adapter.

nodenum

[out] IPX node address for the associated adapter.

wan

[out] Specifies whether the adapter is on a wide area network (WAN) link. When TRUE, the adapter is on a WAN link.

status

[out] Specifies whether the WAN link is up. FALSE indicates that the WAN link is up or the adapter is not on a WAN. Compare with wan to determine the meaning.

maxpkt

[out] Maximum allowable packet size, excluding the IPX header.

linkspeed

[out] Link speed, returned in 100 bytes per second increments. For example, a 9600 byte per second link would be return a value of 96.

Remarks

Adapter numbers are base zero, so if there are eight adapters on a given computer, they are numbered 0-7. To determine the number of adapters present on the computer, call the getsockopt function with IPX_MAX_ADAPTER_NUM.

Requirements

  Version: Requires Windows Sockets 2.0.
  Header: Declared in Wsnwlink.h.

See Also

getsockopt