RasGetSubEntryHandle

DWORD RasGetSubEntryHandle(
  _In_  HRASCONN   hRasConn,
  _In_  DWORD      dwSubEntry,
  _Out_ LPHRASCONN lphRasConn
);

说明

该函数用于获取多链路连接的某个子连接的句柄。

参数

hRasConn [in]

连接句柄，由RasDial对一个多链路的电话簿条目拨号返回。

dwSubEntry [in]

指定电话簿条目的子连接索引。

lphRasConn [out]

指向HRASCONN类型的变量，用于接收子连接的句柄。

返回值

成功时返回ERROR_SUCCESS。
失败时返回以下列表中的值之一或来自Routing and Remote Access Error Codes或Winerror.h中定义的错误码。

值	含义
ERROR_INVALID_HANDLE	hRasConn连接句柄无效。
ERROR_PORT_NOT_OPEN	hRasConn和dwSubEntry参数有效，但指定的子连接未建立。
ERROR_NO_MORE_ITEMS	dwSubEntry超出电话簿条目的子条目最大数量。

注意事项

hRasConn连接句柄描述整个多链路连接，而lphRasConn返回的句柄描述某个子连接。可以在包括RasHangUp,RasGetConnecStatus,RasGetProjectionInfo函数在内的所有接受hRasConn参数的函数中使用子连接句柄。使用多链路连接句柄和使用子连接句柄调用RasGetProjectionInfo返回的映射信息是完全一样的。

可以使用RasHangUp来关闭一个多链路连接中的子连接，但无法通过RasGetConnectStatus函数检测子连接是否已关闭。即使该子连接已成功关闭，针对该子连接调用RasGetConnectStatus函数并不一定会返回ERROR_INVALID_HANDLE错误。

系统支持

客户端最小支持	Windows 2000 专业版
服务端最小支持	Windows 2000 Server
Header	Ras.h
Library	Rasapi32.lib
DLL	Rasapi32.dll
Unicode和ANSI名称	RasGetSubEntryHandleW(Unicode)和RasGetSubEntryHandleA(ANSI)