[New - Windows NT]
RasGetSubEntryHandle函数检索多链接连接的指定子条目的连接句柄。
DWORD RasGetSubEntryHandle(
HRASCONN 【hrasconn】, | |
DWORD 【dwSubEntry】, | |
LPHRASCONN 【lphrasconn】 | |
); |
参数
【hrasconn】
指定RasDial函数返回的多链路电话簿条目的HRASCONN连接句柄。
【dwSubEntry】
指定电话簿条目的有效子条目索引。
【lphrasconn】
指向HRASCONN变量的指针,该变量接收表示子条目连接的连接句柄。
返回值
如果函数成功,返回值为零。
如果函数失败,则返回值可以是以下错误代码之一。
值 | 含义 |
ERROR_INVALID_HANDLE | 【hrasconn】连接句柄不代表已连接的电话簿条目。 |
ERROR_PORT_NOT_OPEN | 【hrasconn】和【dwSubEntry】参数有效,但指定的子条目未连接。 |
ERROR_NO_MORE_ITEMS | 由【dwSubEntry】指定的值超过电话簿条目的最大子条目数。 |
备注
【hrasconn】参数中指定的连接句柄是指整个多链路连接,但【* lphrasconn】参数中返回的连接句柄仅指子条连接。您可以在接受【hrasconn】参数的任何函数中使用子条目连接句柄,其中包括RasHangUp,RasGetConnectStatus和RasGetProjectionInfo函数。RasGetProjectionInfo为多链接条目返回的投影信息对于每个子条目连接句柄与主连接句柄一样。
也可以看看
RasDial, RasGetConnectStatus, RasGetProjectionInfo, RasHangUp