MprAdminInterfaceTransportGetInfo 函数 (mprapi.h)

  • 项目

MprAdminInterfaceTransportGetInfo 函数检索有关在指定接口上运行的传输的信息。

语法

DWORD MprAdminInterfaceTransportGetInfo(
  [in]            MPR_SERVER_HANDLE hMprServer,
  [in]            HANDLE            hInterface,
  [in]            DWORD             dwTransportId,
  [out]           LPBYTE            *ppInterfaceInfo,
  [out, optional] LPDWORD           lpdwInterfaceInfoSize
);

parameters

[in] hMprServer

从中检索信息的路由器的句柄。 通过调用 MprAdminServerConnect 获取此句柄。

[in] hInterface

接口的句柄。 此句柄是从上一次调用 MprAdminInterfaceCreate 获取的。

[in] dwTransportId

描述为其请求信息的传输的 DWORD 值。 下表列出了 dwTransportId 的可接受值。

值 传输 (协议系列)
PID_ATALK AppleTalk
PID_IP Internet 协议版本 4
PID_IPX Internet 数据包交换
PID_NBF NetBIOS 帧协议
PID_IPV6 Windows Server 2008 或更高版本：Internet 协议版本 6

[out] ppInterfaceInfo

指向指针变量的指针。 指针变量指向接收指定接口和传输的信息的信息标头。 使用 信息标头函数 可操作信息标头。 通过调用 MprAdminBufferFree 释放此内存。

[out, optional] lpdwInterfaceInfoSize

指向 DWORD 变量的指针。 此变量接收通过 ppInterfaceInfo 参数返回的接口信息的大小（以字节为单位）。

此参数是可选的。 如果调用应用程序为此参数指定 NULL ，则该函数不会返回接口信息的大小。

返回值

如果函数成功，则返回值NO_ERROR。

如果函数失败，则返回值为以下错误代码之一。

值 含义
ERROR_ACCESS_DENIED
 调用应用程序没有足够的权限。
ERROR_INVALID_HANDLE
 如果指定的接口被管理禁用，则 hInterface 值无效。
ERROR_NO_SUCH_INTERFACE
 指定的传输未在指定的接口上运行。
ERROR_NOT_ENOUGH_MEMORY
 资源不足，无法完成操作。
ERROR_UNKNOWN_PROTOCOL_ID
 dwTransportId 值与任何受支持的传输不匹配。

要求

   
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 mprapi.h
Library Mprapi.lib
DLL Mprapi.dll

另请参阅

MprAdminInterfaceCreate

MprAdminInterfaceTransportSetInfo

MprAdminServerConnect

路由器管理功能

路由器管理参考