RasGetProjectionInfo功能获取有关指定远程访问组件协议的远程访问投影操作的信息。
DWORD RasGetProjectionInfo
HRASCONN 【hrasconn】, | //指定感兴趣的远程访问连接的句柄 |
RASPROJECTION 【rasprojection】, | //指定要获取的投影信息的类型 |
LPVOID 【lpprojection】, | //指向接收投影信息的缓冲区 |
LPDWORD 【LPCB】 | //指向指定缓冲区大小的变量 |
); |
参数
【hrasconn】
处理感兴趣的远程访问连接。应用程序从RasDial或RasEnumConnections功能获取RAS连接句柄。
【rasprojection】
枚举类型值RASPROJECTION ,用于指定感兴趣的协议。
【lpprojection】
指向将接收【rasprojection】参数指定的信息的缓冲区。该信息将在适合【rasprojection】值的结构中:
【rasprojection】值 | 数据结构 |
RASP_Amb | RASAMB |
RASP_PppNbf | RASPPPNBF |
RASP_PppIpx | RASPPPIPX |
RASP_PppIp | RASPPPIP |
【LPCB】
指向一个变量,在条目上指定由【lpprojection】指向的缓冲区的大小(以字节为单位)。在退出时,此变量包含包含指定投影信息所需的缓冲区大小。
返回值
如果函数成功,返回值为零。
如果函数失败,则返回值是错误代码。该函数可能返回非零RAS错误代码或以下错误代码之一:
值 | 含义 |
ERROR_BUFFER_TOO_SMALL | 【lpprojection】指向的缓冲区不够大,无法包含请求的信息。 |
ERROR_INVALID_HANDLE | 【hrasconn】参数不是有效的句柄。 |
ERROR_INVALID_PARAMETER | 其中一个参数无效。 |
ERROR_INVALID_SIZE | 【lpprojection】指向的结构的的dwSize成员指定的大小无效。 |
ERROR_PROTOCOL_NOT_CONFIGURED | 要求信息的控制协议既不成功也不失败,因为连接的电话簿条目不需要尝试协商协议。这是一个RAS错误代码。 |
备注
远程访问投影是远程访问服务器和远程客户端协商网络协议特定信息的过程。远程访问服务器使用此网络协议特定信息来表示网络上的远程客户端。
Windows NT:远程访问投影信息在操作系统执行远程访问连接上的RasDial RASCS_Projected状态之前不可用。如果在RASCS_Projected状态之前调用RasGetProjectionInfo,则返回ERROR_PROJECTION_NOT_COMPLETE。
Windows 95: Windows 95拨号网络不支持RASCS_Projected状态。投影阶段可以在RASCS_Authenticate状态期间完成。如果认证成功,则连接操作进入RASCS_A认证状态,投影信息可用于成功配置的协议。如果在RASCS_A认证状态之前调用RasGetProjectionInfo,则返回ERROR_PROTOCOL_NOT_CONFIGURED。
也可以看看
RASAMB, RasDial, RasEnumConnections, RASPPPNBF, RASPPPIPX, RASPPPIP, RASPROJECTION