RasGetProjectionInfo

DWORD RasGetProjectionInfo(  _In_    HRASCONN      hrasconn,  _In_    RASPROJECTION rasprojection,  _Out_   LPVOID        lpprojection,  _Inout_ LPDWORD       lpcb);

说明

该函数用于获取指定的远程访问组件协议的映射操作信息。

参数

hrasconn [in]

连接句柄。

rasprojection [in]

指定一个RASPROJECTION枚举值用于识别相关协议。

lpprojection [out]

指向一个用于接收信息的缓冲，该缓冲的结构由rasprojection指定的枚举值决定。

枚举值 含义 RASP_Amb RASAMB 注意 支持Windows 2000及早期版本 RASP_PppCcp RASPPPCCP 注意 支持Windows 2000及以后版本 RASP_PppIp RASPPPIP RASP_PppIpv6 RASPPPIPV6 注意 支持Windows Vista及以后版本 RASP_PppIpx RASPPPIPX 注意 不支持64位Windows系统 RASP_PppLcp RASPPPLCP 注意 支持Windows 2000及以后版本 RASP_PppNbf RASPPPNBF 注意 支持Windows 2000及早期版本 RASP_Slip RASPSLIP 注意 支持Windows Server 2003及早期版本

lpcb [in, out]

指向一个变量，用于指示lpprojection参数指向的缓冲字节数。函数返回时设置此变量值为实际需要的字节数。

返回值

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

值 含义 ERROR_BUFFER_TOO_SMALL lpprojection参数指向的缓冲长度不足。 ERROR_INVALID_HANDLE hrasconn句柄无效。 ERROR_INVALID_PARAMETER 其中一个参数无效。 ERROR_INVALID_SIZE lpprojection指向的结构中dwSize成员的值不正确。 ERROR_PROTOCOL_NOT_CONFIGURED 请求获取信息的控制协议未成功运行，因为用于连接的电话簿条目不需要协商该协议。这是一个RAS错误代码。

注意事项

远程访问映射通过远程访问服务器和远程访问客户端之间协商特定网络协议实现。远程访问服务器使用该信息描述一个网络客户端。

在操作系统执行RasDial的RASCS_Projected状态之前，远程访问映射信息是不可访问的。在此前提下会返回ERROR_PROJECTION_NOT_COMPLETE错误。

NetBEUI和AMB(Authentication Message Blocks)仅支持Windows 2000及早期版本的Windows操作系统。

系统支持

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