MprConfigTransportGetHandle 関数 (mprapi.h)

MprConfigTransportGetHandle 関数は、指定したルーター構成で、指定したトランスポートプロトコルの構成へのハンドルを取得します。

構文

DWORD MprConfigTransportGetHandle(
  [in]  HANDLE hMprConfig,
  [in]  DWORD  dwTransportId,
  [out] HANDLE *phRouterTransport
);

[in] hMprConfig

ルーターの構成を処理します。ハンドルは、 MprConfigServerConnect の以前の呼び出しから取得されます。

[in] dwTransportId

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

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

[out] phRouterTransport

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

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

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

値	意味
ERROR_INVALID_PARAMETER	hMprConfig パラメーターまたは phRouterTransport パラメーターが NULL です。
ERROR_NOT_ENOUGH_MEMORY	操作を完了するためのリソースが不足しています。
ERROR_UNKNOWN_PROTOCOL_ID	dwTransportId で指定されたトランスポートプロトコルがルーター構成で見つかりませんでした。
その他	FormatMessage を使用して、返されるエラーコードに対応するシステムエラーメッセージを取得します。