IP_ADAPTER_PREFIX_XP structure (iptypes.h)

The IP_ADAPTER_PREFIX structure stores an IP address prefix.

Syntax

typedef struct _IP_ADAPTER_PREFIX_XP {
  union {
    ULONGLONG Alignment;
    struct {
      ULONG Length;
      DWORD Flags;
    };
  };
  struct _IP_ADAPTER_PREFIX_XP *Next;
  SOCKET_ADDRESS               Address;
  ULONG                        PrefixLength;
} IP_ADAPTER_PREFIX_XP, *PIP_ADAPTER_PREFIX_XP;

Members

Alignment

Reserved. Used by the compiler to align the structure.

Length

The length, in bytes, of this structure.

Flags

This member is reserved and should be set to zero.

Next

A pointer to the next adapter prefix structure in the list.

Address

The address prefix, in the form of a SOCKET_ADDRESS structure.

PrefixLength

The length of the prefix, in bits.

Remarks

The IP_ADAPTER_ADDRESSES structure is retrieved by the GetAdaptersAddresses function. On Windows XP with Service Pack 1 (SP1) and later, the FirstPrefix member of the IP_ADAPTER_ADDRESSES structure is a pointer to a linked list of IP_ADAPTER_PREFIX structures.

The SOCKET_ADDRESS structure is used in the IP_ADAPTER_PREFIX structure. On the Microsoft Windows Software Development Kit (SDK) released for Windows Vista and later, the organization of header files has changed and the SOCKET_ADDRESS structure is defined in the Ws2def.h header file which is automatically included by the Winsock2.h header file. On the Platform Software Development Kit (SDK) released for Windows Server 2003 and Windows XP, the SOCKET_ADDRESS structure is declared in the Winsock2.h header file. In order to use the IP_ADAPTER_PREFIX structure, the Winsock2.h header file must be included before the Iphlpapi.h header file.

Requirements

Requirement Value
Minimum supported client Windows Vista, Windows XP with SP1 [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Header iptypes.h (include Iphlpapi.h)

See also

GetAdaptersAddresses

IP Helper Start Page

IP Helper Structures

IP_ADAPTER_ADDRESSES

SOCKET_ADDRESS