MprConfigInterfaceCreate

[This is preliminary documentation and subject to change.]

The MprConfigInterfaceCreate function creates a router interface in the specified router configuration.

DWORD  
MprConfigInterfaceCreate(
  HANDLE hMprConfig,            // handle to the router configuration 
  DWORD dwLevel,                // level of information requested
  LPBYTE lpbBuffer,             // MPR_INTERFACE_0 structure
  HANDLE * phRouterInterface    // handle to the interface configuration
);

Parameters

hMprConfig

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

dwLevel

Level of information requested. This parameter must be zero.

lpbBuffer

Pointer to an MPR_INTERFACE_0 structure.

phRouterInterface

Pointer to a handle variable. On successful return, this variable will contain a handle to the interface configuration.

Return Values

NO_ERROR

The router interface was created successfully.

ERROR_INVALID_PARAMETER

At least one of the following is true:

hMprConfig is NULL

dwLevel is not zero.

lpbBuffer is NULL

phRouterInterface is NULL

ERROR_NOT_ENOUGH_MEMORY

Insufficient resources to complete the operation.

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, MprConfigInterfaceDelete, MprConfigServerConnect