MprAdminInterfaceCreate

[This is preliminary documentation and subject to change.]

The MprAdminInterfaceCreate function creates an interface on a specified server.

DWORD  MprAdminInterfaceCreate(
  MPR_SERVER_HANDLE hMprServer,    // handle to router
  DWORD dwLevel,                   // level of information provided
  LPBYTE lpBuffer,                 // MPR_INTERFACE_0 structure
  HANDLE * phInterface             // handle to the interface
);

Parameters

hMprServer

Handle to the Windows NT router on which to execute this call. Obtain this handle by calling MprAdminServerConnect.

dwLevel

Level of the information passed in lpBuffer. Must be zero.

lpBuffer

Pointer to an MPR_INTERFACE_0 structure that contains the information to create the interface. The hInterface member of this structure is ignored.

phInterface

Pointer to a HANDLE variable. On successful return, the variable contains a handle to use in all subsequent calls to manage this interface.

Return Values

NO_ERROR

The router interface was created successfully.

ERROR_ACCESS_DENIED

The caller does not have sufficient privilege.

ERROR_DDM_NOT_RUNNING

The router interface type specified in the MPR_INTERFACE_0 structure is not supported because the Dynamic Interface Manager is configured to run only on a LAN.

ERROR_INTERFACE_ALREADY_EXISTS

An interface with the same name already exists.

ERROR_NOT_ENOUGH_MEMORY

Insufficient resources to complete the operation.

ERROR_NOT_SUPPORTED

The dwLevel value is invalid.

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

MPR_INTERFACE_0, MprAdminInterfaceDelete, MprAdminServerConnect