[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 );
Windows 2000 and later: This parameter may have a value of one. A value of one indicates that the lpBuffer parameter points to an MPR_INTERFACE_1 structure.
Windows 2000 and later: The buffer contains either an MPR_INTERFACE_0 or MPR_INTERFACE_1 structure. The type of the structures is indicated by the value of the dwLevel parameter.
If the function succeeds, the return value is NO_ERROR.
If the function fails, the return value is one of the following error codes.
Value | Meaning |
---|---|
ERROR_INVALID_PARAMETER | At least one of the following is true:
|
ERROR_NO_SUCH_INTERFACE | The interface that corresponds to hRouterInterface is not present in the router configuration. |
Other | Use FormatMessage to retrieve the system error message that corresponds to the error code returned. |
Windows 2000 and later: The MprAdminInterfaceSetInfo function supports the MPR_INTERFACE_2 structure. However, MprConfigInterfaceSetInfo does not. In order to make persistent changes to a demand-dial interface, call MprAdminInterfaceSetInfo with MPR_INTERFACE_2, then call MprConfigInterfaceSetInfo with MPR_INTERFACE_0 or MPR_INTERFACE_1.
Windows NT/2000: Requires Windows 2000.
Header: Declared in Mprapi.h.
Library: Use Mprapi.lib.
Router Management Reference, Router Configuration Functions, FormatMessage, MprConfigInterfaceCreate, MprConfigInterfaceEnum, MprConfigInterfaceGetHandle, MprConfigServerConnect