MprConfigServerConnect 関数 (mprapi.h)

MprConfigServerConnect 関数は、構成するルーターに接続します。サーバーに対して他の呼び出しを行う前に、この関数を呼び出します。この関数によって返されるハンドルは、サーバー上のインターフェイスとトランスポートを構成するために、後続の呼び出しで使用されます。

構文

DWORD MprConfigServerConnect(
  [in]  LPWSTR lpwsServerName,
  [out] HANDLE *phMprConfig
);

[in] lpwsServerName

構成するリモートサーバーの名前を指定する Unicode 文字列へのポインター。このパラメーターが NULL の場合、関数はローカルコンピューター上のルーター構成へのハンドルを返します。

[out] phMprConfig

ハンドル変数へのポインター。この変数は、ルーター構成へのハンドルを受け取ります。

関数が成功した場合、戻り値はNO_ERROR。

関数が失敗した場合、戻り値は次のいずれかのエラーコードになります。

値	説明
ERROR_INVALID_PARAMETER	phMprConfig パラメーターは NULL です。
ERROR_NOT_ENOUGH_MEMORY	操作を完了するためのリソースが不足しています。
その他	FormatMessage を使用して、返されたエラーコードに対応するシステムエラーメッセージを取得します。