次の方法で共有


InitializeUnicastIpAddressEntry (Compact 2013)

3/26/2014

This function initializes a MIB_UNICASTIPADDRESS_ROW structure with default values for a unicast IP address entry on the local device

Syntax

VOID NETIOAPI InitializeUnicastIpAddressEntry(
  __out  PMIB_UNICASTIPADDRESS_ROW Row
);

Parameters

  • Row
    On entry, a pointer to a MIB_UNICASTIPADDRESS_ROW structure entry for a unicast IP address entry. On return, the MIB_UNICASTIPADDRESS_ROW structure pointed to by this parameter is initialized with default values for a unicast IP address.

Return Value

This function does not return a value.

Remarks

The InitializeUnicastIpAddressEntry function must be used to initialize the members of a MIB_UNICASTIPADDRESS_ROW structure entry with default values for a unicast IP address for later use with the CreateUnicastIpAddressEntry function.

On input, InitializeUnicastIpAddressEntry must be passed a new MIB_UNICASTIPADDRESS_ROW structure to initialize.

On output, the PrefixOrigin member of the MIB_UNICASTIPADDRESS_ROW structure pointed to by Row parameter the will be initialized to IpPrefixOriginUnchanged, the SuffixOrigin member will be initialized to IpSuffixOriginUnchanged, and the OnLinkPrefixLength member will be initialized to an illegal value. In addition, the PreferredLifetime and ValidLifetime members are set to infinite, the SkipAsSource member is set to FALSE, and other fields are initialized to zero.

After calling InitializeUnicastIpAddressEntry, an application can then change the members in the MIB_UNICASTIPADDRESS_ROW entry it wishes to modify, and then call the CreateUnicastIpAddressEntry to add the new unicast IP address to the local device.

See Also

Reference

IP Helper Functions
CreateUnicastIpAddressEntry
DeleteUnicastIpAddressEntry
GetUnicastIpAddressEntry
GetUnicastIpAddressTable
MIB_UNICASTIPADDRESS_ROW
MIB_UNICASTIPADDRESS_TABLE
NotifyUnicastIpAddressChange
SetUnicastIpAddressEntry

Other Resources

IP Helper