MprConfigInterfaceTransportGetHandle 函数 (mprapi.h)

项目
03/05/2024

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	Internet 协议版本 4
PID_IPX	Internet 数据包交换
PID_NBF	NetBIOS 帧协议
PID_IPV6	Windows Server 2008 或更高版本：Internet 协议版本 6

[out] phRouterIfTransport

指向
HANDLE 变量，用于接收 dwTransportId 参数中指示的此接口的传输配置句柄类型。

返回值

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

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

值	含义
ERROR_INVALID_PARAMETER	以下至少一个条件成立： 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