MprConfigInterfaceTransportGetHandle 関数 (mprapi.h)

[アーティクル]
08/24/2023

MprConfigInterfaceTransportGetHandle 関数は、指定されたルーター構成のインターフェイスのトランスポート構成へのハンドルを取得します。

構文

DWORD MprConfigInterfaceTransportGetHandle(
  [in]  HANDLE hMprConfig,
  [in]  HANDLE hRouterInterface,
  [in]  DWORD  dwTransportId,
  [out] HANDLE *phRouterIfTransport
);

パラメーター

[in] hMprConfig

ルーター構成を処理します。 MprConfigServerConnect を呼び出して、このハンドルを取得します。

[in] hRouterInterface

インターフェイス構成を処理します。 MprConfigInterfaceCreate、MprConfigInterfaceGetHandle、または MprConfigInterfaceEnum を呼び出して、このハンドルを取得します。

[in] dwTransportId

phRouterIfTransport パラメーターのトランスポート構成ハンドルの種類を表す DWORD 値。 dwTransportId に使用できる値を次の表に示します。

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

[out] phRouterIfTransport

へのポインター
dwTransportId パラメーターに示されているこのインターフェイスのトランスポート構成ハンドルの種類を受け取る HANDLE 変数。

戻り値

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

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

値	意味
ERROR_INVALID_PARAMETER	以下のうち少なくとも 1 つが true です。 hMprConfig が NULL です。 hRouterInterface が NULL です。 phRouterIfTransport が NULL です。
ERROR_NOT_ENOUGH_MEMORY	操作を完了するためのリソースが不足しています。
ERROR_NO_SUCH_INTERFACE	hRouterInterface で指定されたインターフェイスがルーター構成で見つからなかったか、dwTransportId で指定されたトランスポートが指定されたインターフェイスで有効になっていませんでした。
その他	FormatMessage を使用して、返されたエラーコードに対応するシステムエラーメッセージを取得します。

要件

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