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)