通过

RasGetProjectionInfoEx 函数 (ras.h)

  • 项目

RasGetProjectionInfoEx 函数获取有关点到点协议的信息， (PPP) 或 Internet 密钥交换版本 2 (IKEv2) 远程访问投影操作在本地客户端上的所有 RAS 连接。

语法

DWORD RasGetProjectionInfoEx(
  [in]      HRASCONN             hrasconn,
  [in, out] PRAS_PROJECTION_INFO pRasProjection,
  [in, out] LPDWORD              lpdwSize
);

参数

[in] hrasconn

要更改其隧道终结点的 RAS 连接的句柄。 这可以是 RasDial 或 RasEnumConnections 函数返回的句柄。

[in, out] pRasProjection

指向接收 RAS 连接的投影信息的 RAS_PROJECTION_INFO 结构的指针。

[in, out] lpdwSize

输入中的指针，指定 pRasProjection 指向的缓冲区的大小（以字节为单位）。 在输出时，此变量接收存储 pRasProjection 指向的RAS_PROJECTION_INFO结构数所需的缓冲区大小（以字节为单位）。

返回值

如果函数成功，则返回值 ERROR_SUCCESS。

如果函数失败，则返回值为以下错误代码之一，或者来自 路由和远程访问错误代码 或 Winerror.h 的值。

值 含义
ERROR_BUFFER_TOO_SMALL
 pRasProjection 指向的缓冲区不够大，无法包含请求的信息。
ERROR_INVALID_HANDLE
 hrasconn 参数不是有效的句柄。
ERROR_INVALID_PARAMETER
 函数是使用无效参数调用的。
ERROR_INVALID_SIZE
 pRasProjection 指向的结构的 dwSize 成员指定了无效的大小。
ERROR_PROTOCOL_NOT_CONFIGURED
 请求其信息的控制协议既不成功也不失败，因为连接的电话簿条目不要求尝试协商协议。

注解

远程访问投影是远程访问服务器和远程客户端协商特定于网络协议的信息的过程。 远程访问服务器使用此特定于网络协议的信息来表示网络上的远程客户端。

在操作系统对远程访问连接执行 RASCS_Projected 状态之前，远程访问投影信息不可用。 如果在RASCS_Projected状态之前调用 RasGetProjectionInfoEx，则返回ERROR_PROJECTION_NOT_COMPLETE。

要求

要求 值
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 ras.h
Library Rasapi32.lib
DLL Rasapi32.dll

另请参阅

远程访问服务 (RAS) 概述

远程访问服务功能