Funzione RasGetProjectionInfoEx (ras.h)

  • Articolo

La funzione RasGetProjectionInfoEx ottiene informazioni sulle operazioni di proiezione di accesso remoto da punto a punto (PPP) o Internet Key Exchange versione 2 (IKEv2) per tutte le connessioni RAS nel client locale.

Sintassi

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

Parametri

[in] hrasconn

Handle alla connessione RAS per cui devono essere modificati gli endpoint del tunnel. Questo può essere un handle restituito dalla funzione RasDial o RasEnumConnections .

[in, out] pRasProjection

Puntatore a una struttura RAS_PROJECTION_INFO che riceve le informazioni di proiezione per le connessioni RAS.

[in, out] lpdwSize

Puntatore, in input, che specifica le dimensioni, in byte, del buffer a cui fa riferimento pRasProjection. Nell'output, questa variabile riceve le dimensioni, in byte, del buffer necessario per archiviare il numero di strutture RAS_PROJECTION_INFO puntate da pRasProjection.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti o un valore da Routing e codici di errore di accesso remoto o Winerror.h.

Valore Significato
ERROR_BUFFER_TOO_SMALL
 Il buffer a cui fa riferimento pRasProjection non è sufficiente per contenere le informazioni richieste.
ERROR_INVALID_HANDLE
 Il parametro hrasconn non è un handle valido.
ERROR_INVALID_PARAMETER
 La funzione è stata chiamata con un parametro non valido.
ERROR_INVALID_SIZE
 Il membro dwSize della struttura a cui fa riferimento pRasProjection specifica una dimensione non valida.
ERROR_PROTOCOL_NOT_CONFIGURED
 Il protocollo di controllo per cui sono state richieste informazioni non riuscite né non riuscite, perché la voce della rubrica telefonica della connessione non richiedeva che venga effettuato un tentativo di negoziazione del protocollo.

Commenti

La proiezione di accesso remoto è il processo in cui un server di accesso remoto e un client remoto negoziano informazioni specifiche del protocollo di rete. Un server di accesso remoto usa queste informazioni specifiche del protocollo di rete per rappresentare un client remoto nella rete.

Le informazioni sulla proiezione dell'accesso remoto non sono disponibili finché il sistema operativo non ha eseguito lo stato RASCS_Projected sulla connessione di accesso remoto. Se RasGetProjectionInfoEx viene chiamato prima dello stato RASCS_Projected , restituisce ERROR_PROJECTION_NOT_COMPLETE.

Requisiti

Requisito Valore
Client minimo supportato Windows 7 [solo app desktop]
Server minimo supportato Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione ras.h
Libreria Rasapi32.lib
DLL Rasapi32.dll

Vedi anche

Panoramica del servizio di accesso remoto (RAS)

Funzioni del Servizio di accesso remoto