MIB_UNICASTIPADDRESS_ROW structure

The MIB_UNICASTIPADDRESS_ROW structure stores information about a unicast IP address.

Syntax

typedef struct _MIB_UNICASTIPADDRESS_ROW {
  SOCKADDR_INET    Address;
  NET_LUID         InterfaceLuid;
  NET_IFINDEX      InterfaceIndex;
  NL_PREFIX_ORIGIN PrefixOrigin;
  NL_SUFFIX_ORIGIN SuffixOrigin;
  ULONG            ValidLifetime;
  ULONG            PreferredLifetime;
  UINT8            OnLinkPrefixLength;
  BOOLEAN          SkipAsSource;
  NL_DAD_STATE     DadState;
  SCOPE_ID         ScopeId;
  LARGE_INTEGER    CreationTimeStamp;
} MIB_UNICASTIPADDRESS_ROW, *PMIB_UNICASTIPADDRESS_ROW;

Members

  • Address
    The unicast IP address. This member can be an IPv6 address or an IPv4 address.

  • InterfaceLuid
    The locally unique identifier (LUID) for the network interface that is associated with this IP address.

  • InterfaceIndex
    The local index value for the network interface that is associated with this IP address. This index value might change when a network adapter is disabled and then enabled, or under other circumstances, and should not be considered persistent.

  • PrefixOrigin
    An NL_PREFIX_ORIGIN type that specifies the origin of the prefix or network part of the IP address.

  • SuffixOrigin
    An NL_SUFFIX_ORIGIN type that specifies the origin of the suffix or host part of the IP address.

  • ValidLifetime
    The maximum time, in seconds, that the IP address is valid. A value of 0xffffffff is considered to be infinite.

  • PreferredLifetime
    The preferred time, in seconds, that the IP address is valid. A value of 0xffffffff is considered to be infinite.

  • OnLinkPrefixLength
    The length, in bits, of the prefix or network part of the IP address. For a unicast IPv4 address, any value that is greater than 32 is an illegal value. For a unicast IPv6 address, any value that is greater than 128 is an illegal value. A value of 255 is typically used to represent an illegal value.

  • SkipAsSource
    A value that specifies if the address can be used as an IP source address.

  • DadState
    A NL_DAD_STATE duplicate address detection (DAD) type.

  • ScopeId
    The scope ID of the IP address. This member is applicable only to an IPv6 address. Your driver cannot set this member. This member is automatically determined by the interface that the address was added on.

  • CreationTimeStamp
    The time stamp when the IP address was created.

Requirements

Version

Available in Windows Vista and later versions of the Windows operating systems.

Header

Netioapi.h (include Netioapi.h)

See also

CreateUnicastIpAddressEntry

DeleteUnicastIpAddressEntry

GetUnicastIpAddressEntry

GetUnicastIpAddressTable

InitializeUnicastIpAddressEntry

MIB_UNICASTIPADDRESS_TABLE

NL_DAD_STATE

NL_PREFIX_ORIGIN

NL_SUFFIX_ORIGIN

SetUnicastIpAddressEntry