MprConfigInterfaceSetInfo

[This is preliminary documentation and subject to change.]

The MprConfigInterfaceSetInfo function sets the configuration for the specified interface.

DWORD  MprConfigInterfaceSetInfo(
  HANDLE hMprConfig,          // handle to the router configuration
  HANDLE hRouterInterface,    // handle to the interface configuration
  DWORD dwLevel,              // level of the information requested
  LPBYTE lpBuffer             // MPR_INTERFACE_0 structure
);

Parameters

hMprConfig

Handle to the router configuration. Obtain this handle by calling MprConfigServerConnect.

hRouterInterface

Handle to the interface configuration being updated. Obtain this handle by calling MprConfigInterfaceCreate, MprConfigInterfaceGetHandle, or MprConfigInterfaceEnum.

dwLevel

Level of the information in the lpBuffer parameter. This parameter must be zero.

lpBuffer

Pointer to a buffer containing an MPR_INTERFACE_0 structure. The information in this buffer is used to update the interface configuration.

Return Values

NO_ERROR

The interface information was set successfully.

ERROR_INVALID_PARAMETER

At least one of the following is true:

hMprConfig is NULL.

HRouterInterface is NULL.

dwLevel is not zero.

lpBuffer is NULL.

ERROR_NO_SUCH_INTERFACE

The interface corresponding to hRouterInterface is not present in the router configuration.

Other

Use FormatMessage to retrieve the system error message corresponding to the error code returned.

QuickInfo

  Windows NT: Use version 5.0 and later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in mprapi.h.
  Import Library: Link with mprapi.lib.

See Also

FormatMessage, MprConfigInterfaceCreate, MprConfigInterfaceEnum, MprConfigInterfaceGetHandle, MprConfigServerConnect