Fonction RasGetProjectionInfoEx (ras.h)

  • Article

La fonction RasGetProjectionInfoEx obtient des informations sur les opérations de projection d’accès à distance ppp (Point-to-Point Protocol) ou Internet Key Exchange version 2 (IKEv2) pour toutes les connexions RAS sur le client local.

Syntaxe

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

Paramètres

[in] hrasconn

Handle de la connexion RAS pour laquelle les points de terminaison de tunnel doivent être modifiés. Il peut s’agir d’un handle retourné par la fonction RasDial ou RasEnumConnections .

[in, out] pRasProjection

Pointeur vers une structure RAS_PROJECTION_INFO qui reçoit les informations de projection pour les connexions RAS.

[in, out] lpdwSize

Pointeur, en entrée, qui spécifie la taille, en octets, de la mémoire tampon pointée par pRasProjection. À la sortie, cette variable reçoit la taille, en octets, de la mémoire tampon nécessaire pour stocker le nombre de structures RAS_PROJECTION_INFO pointées par pRasProjection.

Valeur retournée

Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.

Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants ou une valeur provenant des codes d’erreur de routage et d’accès à distance ou winerror.h.

Valeur Signification
ERROR_BUFFER_TOO_SMALL
 La mémoire tampon pointée par pRasProjection n’est pas assez grande pour contenir les informations demandées.
ERROR_INVALID_HANDLE
 Le paramètre hrasconn n’est pas un handle valide.
ERROR_INVALID_PARAMETER
 La fonction a été appelée avec un paramètre non valide.
ERROR_INVALID_SIZE
 Le membre dwSize de la structure pointée par pRasProjection spécifie une taille non valide.
ERROR_PROTOCOL_NOT_CONFIGURED
 Le protocole de contrôle pour lequel des informations ont été demandées n’a ni réussi ni échoué, car la saisie de l’annuaire téléphonique de la connexion n’exigeait pas qu’une tentative de négociation du protocole soit effectuée.

Remarques

La projection d’accès à distance est le processus par lequel un serveur d’accès à distance et un client distant négocient des informations spécifiques au protocole réseau. Un serveur d’accès à distance utilise ces informations spécifiques au protocole réseau pour représenter un client distant sur le réseau.

Les informations de projection d’accès à distance ne sont pas disponibles tant que le système d’exploitation n’a pas exécuté l’état RASCS_Projected sur la connexion d’accès à distance. Si RasGetProjectionInfoEx est appelé avant l’état RASCS_Projected , il retourne ERROR_PROJECTION_NOT_COMPLETE.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête ras.h
Bibliothèque Rasapi32.lib
DLL Rasapi32.dll

Voir aussi

Vue d’ensemble du service d’accès à distance (RAS)

Fonctions du service d’accès à distance