MprAdminInterfaceQueryUpdateResult 関数 (mprapi.h)

  • [アーティクル]

MprAdminInterfaceQueryUpdateResult 関数は、インターフェイスのルートを更新するために、指定されたルーター マネージャーに対する最後の要求の結果を返します。 詳細については、「 MprAdminInterfaceUpdateRoutes」を参照してください。

構文

DWORD MprAdminInterfaceQueryUpdateResult(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  HANDLE            hInterface,
  [in]  DWORD             dwProtocolId,
  [out] LPDWORD           lpdwUpdateResult
);

パラメーター

[in] hMprServer

情報の取得元のルーターを処理します。 MprAdminServerConnect を呼び出して、このハンドルを取得します。

[in] hInterface

インターフェイスへのハンドル。 このハンドルは、 MprAdminInterfaceCreate の以前の呼び出しから取得されます。

[in] dwProtocolId

クエリを実行するルーター マネージャーを指定する DWORD 値。 ルーターは、トランスポート プロトコルごとに異なるルーター マネージャーを使用します。 dwTransportId に使用できる値を次の表に示します。

値 トランスポート (プロトコル ファミリ)
PID_ATALK Appletalk
PID_IP インターネット プロトコル バージョン 4
PID_IPX インターネット パケット交換
PID_NBF NetBIOS フレーム プロトコル
PID_IPV6 Windows Server 2008 以降: インターネット プロトコル バージョン 6

[out] lpdwUpdateResult

DWORD 変数へのポインター。 この変数は、 MprAdminInterfaceUpdateRoutes の最後の呼び出しの結果を受け取ります。

戻り値

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

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

値 意味
ERROR_ACCESS_DENIED
 呼び出し元のアプリケーションに十分な特権がありません。
ERROR_INTERFACE_NOT_CONNECTED
 指定したインターフェイスが接続されていません。最後の更新の結果は使用できなくなりました。
ERROR_INVALID_HANDLE
 hInterface 値が無効です。
ERROR_INVALID_PARAMETER
 lpdwUpdateResult パラメーターは NULL です。
ERROR_NO_SUCH_INTERFACE
 指定したトランスポートが、指定したインターフェイスで実行されていません。
ERROR_UNKNOWN_PROTOCOL_ID
 dwProtocolId 値は、サポートされているルーター マネージャーと一致しません。

注釈

dwProtocolId パラメーターは、トランスポートとルーター マネージャーの両方を指定します。これは、ルーターがトランスポートごとにルーター マネージャーを保持するためです。

要件

要件 値
サポートされている最小のクライアント サポートなし
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー mprapi.h
Library Mprapi.lib
[DLL] Mprapi.dll

こちらもご覧ください

MprAdminInterfaceCreate

MprAdminInterfaceUpdateRoutes

MprAdminServerConnect

ルーター管理機能

ルーター管理リファレンス