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

[out] phRouterTransport

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

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

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

值	含义
ERROR_INVALID_PARAMETER	hMprConfig 参数和/或 phRouterTransport 参数为 NULL。
ERROR_NOT_ENOUGH_MEMORY	资源不足，无法完成操作。
ERROR_UNKNOWN_PROTOCOL_ID	在路由器配置中找不到 dwTransportId 指定的传输协议。
其他	使用 FormatMessage 检索与返回的错误代码对应的系统错误消息。