MprAdminServerConnect 函数 (mprapi.h)

MprAdminServerConnect 函数建立与路由器的连接，以便管理该路由器。在对服务器进行任何其他调用之前调用此函数。使用在后续调用中返回的句柄来管理服务器上的接口。

语法

DWORD MprAdminServerConnect(
  [in, optional] LPWSTR            lpwsServerName,
  [out]          MPR_SERVER_HANDLE *phMprServer
);

[in, optional] lpwsServerName

指向以 null 结尾的 Unicode 字符串的指针，该字符串指定远程服务器的名称。如果此参数为 NULL，则该函数将返回本地计算机的句柄。

[out] phMprServer

指向 HANDLE 变量的指针，该变量接收服务器的句柄。在后续调用中使用此句柄来管理服务器。

如果函数成功，则返回值NO_ERROR。

如果函数失败，则返回值为以下错误代码之一。

值	含义
ERROR_ACCESS_DENIED	调用应用程序没有足够的权限。
RPC_S_INVALID_BINDING	调用此函数时，phMprServer 参数等于 NULL。
RPC_S_UNKNOWN_IF	指定的计算机未运行路由和 RAS 服务。

必须使用 MprAdminIsServiceRunning 来确定远程服务器上的 RRAS 服务的状态。建立连接时，MprAdminServerConnect 不会查询 RRAS 服务。