MprConfigServerConnect

[This is preliminary documentation and subject to change.]

The MprConfigServerConnect function connects to the Windows NT router machine to be configured. Call this function before making any other calls to the server. The handle returned by this function is used in subsequent calls to configure interfaces and transports on the server.

DWORD  MprConfigServerConnect(
  LPWSTR lpwsServerName,    // address of server name
  HANDLE * phMprConfig      // address of router configuration handle
);

Parameters

lpwsServername

Pointer to a Unicode string containing the name of the remote server to configure. If this parameter is NULL, the function returns a handle to the router configuration on the local machine .

phMprConfig

Pointer to a handle variable. On successful return, this variable contains a handle to the router configuration.

Return Values

NO_ERROR

Success.

ERROR_INVALID_PARAMETER

The phMprConfig parameter 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, MprConfigServerDisconnect