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 服務。