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	この関数は、null と等しい phMprServer パラメーターを使用して呼び出されました。
RPC_S_UNKNOWN_IF	指定されたコンピューターでルーティングと RAS サービスが実行されていません。

MprAdminIsServiceRunning を使用して、リモートサーバー上の RRAS サービスの状態を確認する必要があります。 MprAdminServerConnect は、接続の確立時に RRAS サービスに対してクエリを実行しません。