MprAdminInterfaceTransportGetInfo 関数 (mprapi.h)
MprAdminInterfaceTransportGetInfo 関数は、指定したインターフェイスで実行されているトランスポートに関する情報を取得します。
構文
DWORD MprAdminInterfaceTransportGetInfo(
[in] MPR_SERVER_HANDLE hMprServer,
[in] HANDLE hInterface,
[in] DWORD dwTransportId,
[out] LPBYTE *ppInterfaceInfo,
[out, optional] LPDWORD lpdwInterfaceInfoSize
);
パラメーター
[in] hMprServer
情報の取得元のルーターを処理します。 MprAdminServerConnect を呼び出して、このハンドルを取得します。
[in] hInterface
インターフェイスへのハンドル。 このハンドルは、 MprAdminInterfaceCreate の以前の呼び出しから取得されます。
[in] dwTransportId
情報が要求されるトランスポートを表す DWORD 値。 dwTransportId に使用できる値を次の表に示します。
| 値 | トランスポート (プロトコル ファミリ) |
|---|---|
| PID_ATALK | Appletalk |
| PID_IP | インターネット プロトコル バージョン 4 |
| PID_IPX | インターネット パケット交換 |
| PID_NBF | NetBIOS フレーム プロトコル |
| PID_IPV6 | Windows Server 2008 以降: インターネット プロトコル バージョン 6 |
[out] ppInterfaceInfo
ポインター変数へのポインター。 ポインター変数は、指定されたインターフェイスとトランスポートの情報を受け取る情報ヘッダーを指します。 情報ヘッダー関数を使用して、情報ヘッダーを操作します。 MprAdminBufferFree を呼び出して、このメモリを解放します。
[out, optional] lpdwInterfaceInfoSize
DWORD 変数へのポインター。 この変数は、 ppInterfaceInfo パラメーターを介して返されるインターフェイス情報のサイズをバイト単位で受け取ります。
このパラメーターは省略可能です。 呼び出し元のアプリケーションがこのパラメーターに NULL を 指定した場合、関数はインターフェイス情報のサイズを返しません。
戻り値
関数が成功した場合、戻り値はNO_ERROR。
関数が失敗した場合、戻り値は次のいずれかのエラー コードになります。
| 値 | 説明 |
|---|---|
|
呼び出し元のアプリケーションに十分な特権がありません。 |
|
hInterface 値が無効であるか、指定されたインターフェイスが管理上無効になっている場合は 。 |
|
指定したトランスポートが、指定したインターフェイスで実行されていません。 |
|
操作を完了するためのリソースが不足しています。 |
|
dwTransportId 値は、サポートされているトランスポートと一致しません。 |
要件
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | mprapi.h |
| Library | Mprapi.lib |
| [DLL] | Mprapi.dll |