Funzione RasGetProjectionInfoEx (ras.h)
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 |
|---|---|
|
Il buffer a cui fa riferimento pRasProjection non è sufficiente per contenere le informazioni richieste. |
|
Il parametro hrasconn non è un handle valido. |
|
La funzione è stata chiamata con un parametro non valido. |
|
Il membro dwSize della struttura a cui fa riferimento pRasProjection specifica una dimensione non valida. |
|
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 |