Expand Minimize

InitializeIpInterfaceEntry function

The InitializeIpInterfaceEntry function initializes the members of an MIB_IPINTERFACE_ROW entry with default values.

Syntax


VOID InitializeIpInterfaceEntry(
  _Inout_  PMIB_IPINTERFACE_ROW Row
);

Parameters

Row [in, out]

A pointer to a MIB_IPINTERFACE_ROW structure to initialize. On successful return, the fields in this parameter are initialized with default information for an interface on the local computer.

Return value

This function does not return a value.

Remarks

The InitializeIpInterfaceEntry function is defined on Windows Vista and later.

On output, the Family member in the MIB_IPINTERFACE_ROW structure pointed to by the Row parameter will be initialized to either AF_UNSPEC, the InterfaceLuid member in the MIB_IPINTERFACE_ROW structure will be initialized to an unspecified value, and other fields are initialized to zero.

The InitializeIpInterfaceEntry function must be used to initialize the fields of a MIB_IPINTERFACE_ROW structure entry with default values. An application can then change the fields in the MIB_IPINTERFACE_ROW entry it wishes to modify, and then call the SetIpInterfaceEntry function.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Netioapi.h (include Iphlpapi.h)

Library

Iphlpapi.lib

DLL

Iphlpapi.dll

See also

GetIpInterfaceEntry
GetIpInterfaceTable
IP Helper Function Reference
MIB_IPINTERFACE_ROW
MIB_IPINTERFACE_TABLE
SetIpInterfaceEntry

 

 

Community Additions

ADD
Show:
© 2014 Microsoft