InitializeIpInterfaceEntry function

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

Syntax

VOID NETIOAPI_API_ 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

InitializeIpInterfaceEntry returns STATUS_SUCCESS if the function succeeds.

If the function fails, InitializeIpInterfaceEntry returns one of the following error codes:

Return code Description
STATUS_INVALID_PARAMETER

An invalid parameter was passed to the function. This error is returned if a NULL pointer is passed in the Row parameter

Other

Use the FormatMessage function to obtain the message string for the returned error.

Remarks

On output, the members of the MIB_IPINTERFACE_ROW structure that the Row parameter points to are initialized as follows.

  • Family
    Set to AF_UNSPEC.

  • InterfaceLuid
    Set to an unspecified value.

  • All other members
    Set to zero.

Your driver must use the InitializeIpInterfaceEntry function to initialize the fields of a MIB_IPINTERFACE_ROW structure entry with default values. A driver can then change the fields in the MIB_IPINTERFACE_ROW entry that it wants to modify, and then call the SetIpInterfaceEntry function.

Requirements

Target platform

Universal

Version

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

Header

Netioapi.h (include Netioapi.h)

Library

Netio.lib

IRQL

< DISPATCH_LEVEL

See also

GetIpInterfaceEntry

GetIpInterfaceTable

MIB_IPINTERFACE_ROW

MIB_IPINTERFACE_TABLE

SetIpInterfaceEntry

Send comments about this topic to Microsoft