SetIfEntry

  • Article

Use the SetIfEntry function to set the administrative status of an interface.

DWORD SetIfEntry( 
PMIB_IFROW pIfRow // specifies interface and status);

Parameters

  • pIfRow
    Pointer to a MIB_IFROW structure. The dwIndex member of this structure should specify the interface on which to set administrative status. The dwAdminStatus member specifies the new administrative status. The dwAdminStatus member can be one of the following values.
    Value Description
    MIB_IF_ADMIN_STATUS_UP The interface is administratively enabled.
    MIB_IF_ADMIN_STATUS_DOWN The interface is administratively disabled.

Return Values

If the function succeeds, the return value is NO_ERROR.

If the function fails, use FormatMessage to obtain the message string for the returned error.

Requirements

Runs On Versions Defined in Include Link to
Windows CE OS 3.0 and later Iphlpapi.h   Iphlpapi.lib

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

FormatMessage, MIB_IFROW

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.