Compartir a través de

Función RasGetProjectionInfoEx (ras.h)

  • Artículo

La función RasGetProjectionInfoEx obtiene información sobre las operaciones de proyección de acceso remoto de punto a punto (PPP) o intercambio de claves de Internet versión 2 (IKEv2) para todas las conexiones RAS en el cliente local.

Sintaxis

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

Parámetros

[in] hrasconn

Identificador de la conexión RAS para la que se van a cambiar los puntos de conexión de túnel. Puede ser un identificador devuelto por la función RasDial o RasEnumConnections .

[in, out] pRasProjection

Puntero a una estructura de RAS_PROJECTION_INFO que recibe la información de proyección de las conexiones RAS.

[in, out] lpdwSize

Puntero, en entrada, que especifica el tamaño, en bytes, del búfer al que apunta pRasProjection. En la salida, esta variable recibe el tamaño, en bytes, del búfer necesario para almacenar el número de estructuras de RAS_PROJECTION_INFO a las que apunta pRasProjection.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto se ERROR_SUCCESS.

Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error o un valor de Códigos de error de enrutamiento y acceso remoto o Winerror.h.

Valor Significado
ERROR_BUFFER_TOO_SMALL
 El búfer al que apunta pRasProjection no es lo suficientemente grande como para contener la información solicitada.
ERROR_INVALID_HANDLE
 El parámetro hrasconn no es un identificador válido.
ERROR_INVALID_PARAMETER
 Se llamó a la función con un parámetro no válido.
ERROR_INVALID_SIZE
 El miembro dwSize de la estructura a la que apunta pRasProjection especifica un tamaño no válido.
ERROR_PROTOCOL_NOT_CONFIGURED
 El protocolo de control para el que se solicitó información no se realizó correctamente ni falló, ya que la entrada de la libreta de teléfonos de la conexión no requería que se intentara negociar el protocolo.

Comentarios

La proyección de acceso remoto es el proceso en el que un servidor de acceso remoto y un cliente remoto negocian información específica del protocolo de red. Un servidor de acceso remoto usa esta información específica del protocolo de red para representar un cliente remoto en la red.

La información de proyección de acceso remoto no está disponible hasta que el sistema operativo haya ejecutado el estado RASCS_Projected en la conexión de acceso remoto. Si se llama a RasGetProjectionInfoEx antes del estado RASCS_Projected , devuelve ERROR_PROJECTION_NOT_COMPLETE.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ras.h
Library Rasapi32.lib
Archivo DLL Rasapi32.dll

Consulte también

Información general sobre el servicio de acceso remoto (RAS)

Funciones del Servicio de acceso remoto