DWORD WINAPI RasGetProjectionInfoEx(
_In_ HRASCONN Hrasconn,
_Inout_ PRAS_PROJECTION_INFO pRasProjection,
_Inout_ LPDWORD lpdwSize
);
说明
该函数用于获取PPP协议或网络密钥交换版本2协议的远程访问映射操作信息,支持本地所有RAS连接。
参数
Hrasconn [in]
连接句柄。
pRasProjection [in, out]
指向RAS_PROJECTION_INFO结构,用于接收RAS连接的映射信息。
lpdwSize [in, out]
指向一个变量,用于指示pRasProjection参数指向的缓冲字节数。函数返回时会设置该变量为实际需要的字节数。
返回值
成功时返回ERROR_SUCCESS。
失败时返回以下列表中的值之一或来自Routing and Remote Access Error Codes或Winerror.h中定义的错误码。
值 | 含义 |
---|---|
ERROR_BUFFER_TOO_SMALL | pRasProjection参数指向的缓冲长度不足。 |
ERROR_INVALID_HANDLE | hrasconn参数无效。 |
ERROR_INVALID_PARAMETER | 其中一个参数无效。 |
ERROR_INVALID_SIZE | pRasProjection->dwSize的值不正确。 |
ERROR_PROTOCOL_NOT_CONFIGURED | 请求获取信息的控制协议未成功运行,因为用于连接的电话簿条目不需要协商该协议。 |
注意事项
远程访问映射通过远程访问服务器和远程访问客户端之间协商特定网络协议实现。远程访问服务器使用该信息描述一个网络客户端。
在操作系统执行RasDial的RASCS_Projected状态之前,远程访问映射信息是不可访问的。在此前提下会返回ERROR_PROJECTION_NOT_COMPLETE错误。
系统支持
客户端最小支持 | Windows 7 |
---|---|
服务端最小支持 | Windows Server 2008 R2 |
Header | Ras.h |
Library | Rasapi32.lib |
DLL | Rasapi32.dll |