struttura PPP_PROJECTION_INFO (mprapi.h)

Articolo
08/24/2023

La struttura PPP_PROJECTION_INFO contiene informazioni ottenute durante la negoziazione POINT-to-Point (PPP) per Secure Socket Tunneling Protocol (SSTP), PPTP (Point-to-Point Tunneling Protocol) e L2TP (Layer 2 Tunneling Protocol).

Sintassi

typedef struct _PPP_PROJECTION_INFO {
  DWORD   dwIPv4NegotiationError;
  WCHAR   wszAddress[IPADDRESSLEN + 1];
  WCHAR   wszRemoteAddress[IPADDRESSLEN + 1];
  DWORD   dwIPv4Options;
  DWORD   dwIPv4RemoteOptions;
  ULONG64 IPv4SubInterfaceIndex;
  DWORD   dwIPv6NegotiationError;
  BYTE    bInterfaceIdentifier[8];
  BYTE    bRemoteInterfaceIdentifier[8];
  BYTE    bPrefix[8];
  DWORD   dwPrefixLength;
  ULONG64 IPv6SubInterfaceIndex;
  DWORD   dwLcpError;
  DWORD   dwAuthenticationProtocol;
  DWORD   dwAuthenticationData;
  DWORD   dwRemoteAuthenticationProtocol;
  DWORD   dwRemoteAuthenticationData;
  DWORD   dwLcpTerminateReason;
  DWORD   dwLcpRemoteTerminateReason;
  DWORD   dwLcpOptions;
  DWORD   dwLcpRemoteOptions;
  DWORD   dwEapTypeId;
  DWORD   dwRemoteEapTypeId;
  DWORD   dwCcpError;
  DWORD   dwCompressionAlgorithm;
  DWORD   dwCcpOptions;
  DWORD   dwRemoteCompressionAlgorithm;
  DWORD   dwCcpRemoteOptions;
} PPP_PROJECTION_INFO, *PPPP_PROJECTION_INFO;

Members

dwIPv4NegotiationError

Valore che specifica il risultato della negoziazione del protocollo di controllo di rete IPv4 DI PPP. Un valore pari a zero indica che Ipv4 è stato negoziato correttamente. Un valore diverso da zero indica un errore ed è l'errore irreversibile che si è verificato durante la negoziazione del protocollo di controllo.

wszAddress[IPADDRESSLEN + 1]

Matrice che contiene una stringa Unicode che specifica l'indirizzo IPv4 del client locale. Questa stringa ha il formato "a.b.c.d". wszAddress è valido solo se dwIPv4NegotiationError è zero.

wszRemoteAddress[IPADDRESSLEN + 1]

Matrice che contiene una stringa Unicode che specifica l'indirizzo IPv4 del server remoto. Questa stringa ha il formato "a.b.c.d". wszRemoteAddress è valido solo se dwIPv4NegotiationError è zero. Se l'indirizzo non è disponibile, questo membro è una stringa vuota.

dwIPv4Options

Valore che specifica le opzioni IPCP per il client locale.

Valore	Significato
PPP_IPCP_VJ	Indica che i datagrammi IP inviati dal client locale vengono compressi tramite la compressione Van Jacobson.

dwIPv4RemoteOptions

Valore che specifica le opzioni IPCP per il server remoto.

Valore	Significato
PPP_IPCP_VJ	Indica che i datagrammi IP inviati dal server remoto (ovvero ricevuti dal computer locale) vengono compressi tramite la compressione Van Jacobson.

IPv4SubInterfaceIndex

Valore che specifica l'indice dell'interfaccia secondaria IPv4 corrispondente alla connessione nel server.

dwIPv6NegotiationError

Valore che specifica il risultato della negoziazione del protocollo di controllo di rete IPv6 DI PPP. Un valore pari a zero indica che Ipv6 è stato negoziato correttamente. Un valore diverso da zero indica un errore ed è l'errore irreversibile che si è verificato durante la negoziazione del protocollo di controllo.

bInterfaceIdentifier[8]

Matrice che specifica l'identificatore di interfaccia IPv6 a 64 bit del client. Gli ultimi 64 bit di un indirizzo Internet IPv6 a 128 bit vengono considerati l'"identificatore di interfaccia", che fornisce un forte livello di univocità per i 64 bit precedenti. bInterfaceIdentifier è valido solo se dwIPv6NegotiationError è zero e non deve essere zero.

bRemoteInterfaceIdentifier[8]

Matrice che specifica l'identificatore di interfaccia IPv6 a 64 bit del server. Gli ultimi 64 bit di un indirizzo Internet IPv6 a 128 bit vengono considerati l'"identificatore di interfaccia", che fornisce un forte livello di univocità per i 64 bit precedenti. bInterfaceIdentifier è valido solo se dwIPv6NegotiationError è zero e non deve essere zero.

bPrefix[8]

Valore che specifica il prefisso dell'indirizzo IPv6 dell'interfaccia client.

dwPrefixLength

Valore che specifica la lunghezza, in bit, di bPrefix.

IPv6SubInterfaceIndex

Valore che specifica l'indice dell'interfaccia secondaria IPv6 corrispondente alla connessione nel server.

dwLcpError

Valore che specifica il risultato della negoziazione LCP PPP. Un valore pari a zero indica che LCP è stato negoziato correttamente. Un valore diverso da zero indica un errore ed è l'errore irreversibile che si è verificato durante la negoziazione del protocollo di controllo.

dwAuthenticationProtocol

Valore che specifica il protocollo di autenticazione utilizzato per autenticare il client locale. Questo membro può essere uno dei valori seguenti.

Valore	Significato
PPP_LCP_PAP	Protocollo di autenticazione password.
PPP_LCP_CHAP	Challenge Handshake Authentication Protocol.
PPP_LCP_EAP	Extensible Authentication Protocol.

dwAuthenticationData

Valore che specifica informazioni aggiuntive sul protocollo di autenticazione specificato da dwAuthenticationProtocol. Questo membro può essere uno dei valori seguenti:

Valore	Significato
PPP_LCP_CHAP_MD5	MD5 CHAP
PPP_LCP_CHAP_MS	Microsoft CHAP.
PPP_LCP_CHAP_MSV2	Microsoft CHAP versione 2.

dwRemoteAuthenticationProtocol

Valore che specifica il protocollo di autenticazione utilizzato per autenticare il server remoto. dwAuthenticationProtocol e dwRemoteAuthenticationProtocol differiscono quando la composizione della richiesta usa protocolli di autenticazione diversi nel client e nel server. Questo membro può essere uno dei valori seguenti:

Valore	Significato
PPP_LCP_PAP	Protocollo di autenticazione password.
PPP_LCP_CHAP	Challenge Handshake Authentication Protocol.
PPP_LCP_EAP	Extensible Authentication Protocol.

dwRemoteAuthenticationData

Valore che specifica informazioni aggiuntive sul protocollo di autenticazione specificato da dwRemoteAuthenticationProtocol. dwAuthenticationData e dwRemoteAuthenticationData differiscono quando la composizione della richiesta usa protocolli di autenticazione diversi nel client e nel server. Questo membro può essere uno dei valori seguenti:

Valore	Significato
PPP_LCP_CHAP_MD5	MD5 CHAP.
PPP_LCP_CHAP_MS	Microsoft CHAP.
PPP_LCP_CHAP_MSV2	Microsoft CHAP versione 2.

dwLcpTerminateReason

Riservato per utilizzi futuri. Deve essere zero.

dwLcpRemoteTerminateReason

Riservato per utilizzi futuri. Deve essere zero.

dwLcpOptions

Valore che specifica le informazioni sulle opzioni LCP in uso dal client locale. Questo membro è una combinazione dei flag seguenti:

Valore	Significato
PPP_LCP_MULTILINK_FRAMING	La connessione usa il multilink.
PPP_LCP_PFC	La connessione usa la compressione dei campi protocollo (RFC 1172).
PPP_LCP_ACFC	La connessione usa la compressione dei campi di controllo e indirizzo (RFC 1172).
PPP_LCP_SSHF	La connessione usa short sequence number header format (vedere RFC 1990).
PPP_LCP_DES_56	La connessione usa la crittografia DES a 56 bit.
PPP_LCP_3_DES	La connessione usa Triple DES Encryption.
PPP_LCP_AES_128	La connessione usa crittografia AES a 128 bit.
PPP_LCP_AES_256	La connessione usa crittografia AES a 256 bit.

dwLcpRemoteOptions

Valore che specifica informazioni sulle opzioni LCP in uso dal server remoto. Questo membro è una combinazione dei flag seguenti:

Valore	Significato
PPP_LCP_MULTILINK_FRAMING	La connessione usa multilink.
PPP_LCP_PFC	La connessione usa la compressione campo protocollo (RFC 1172).
PPP_LCP_ACFC	La connessione usa la compressione campo indirizzo e controllo (RFC 1172).
PPP_LCP_SSHF	La connessione usa short sequence number header format (vedere RFC 1990).
PPP_LCP_DES_56	La connessione usa la crittografia DES a 56 bit.
PPP_LCP_3_DES	La connessione usa Triple DES Encryption.
PPP_LCP_AES_128	La connessione usa crittografia AES a 128 bit
PPP_LCP_AES_256	La connessione usa crittografia AES a 256 bit.

dwEapTypeId

Valore che specifica l'identificatore di tipo del protocollo EAP (Extensible Authentication Protocol) usato per autenticare il client locale. Il valore di questo membro è valido solo se dwAuthenticationProtocol è PPP_LCP_EAP.

dwRemoteEapTypeId

Valore che specifica l'identificatore di tipo del protocollo EAP (Extensible Authentication Protocol) usato per autenticare il server remoto. Il valore di questo membro è valido solo se dwRemoteAuthenticationProtocol è PPP_LCP_EAP.

dwCcpError

Valore che specifica il risultato della negoziazione PPP CCP. Un valore pari a zero indica che il CCP è stato negoziato correttamente. Un valore diverso da zero indica un errore ed è l'errore irreversibile che si è verificato durante la negoziazione del protocollo di controllo.

dwCompressionAlgorithm

Valore che specifica l'algoritmo di compressione usato dal client locale. La tabella seguente mostra i valori possibili per questo membro.

Valore	Significato
RASCCPCA_MPPC	Protocollo MPPC (Microsoft Point-to-Point Compression) (RFC 2118).
RASCCPCA_STAC	Opzione STAC 4 (RFC 1974).

dwCcpOptions

Valore che specifica i tipi di compressione disponibili nel client locale. Sono supportati i tipi seguenti:

Valore	Significato
PPP_CCP_COMPRESSION	Compressione senza crittografia.
PPP_CCP_HISTORYLESS	Crittografia da punto a punto microsoft (MPPE) in modalità senza stato. La chiave di sessione viene modificata dopo ogni pacchetto. Questa modalità migliora le prestazioni in reti a latenza elevata o reti che riscontrano una perdita significativa di pacchetti.
PPP_CCP_ENCRYPTION40BITOLD	Compressione MPPE usando chiavi a 40 bit.
PPP_CCP_ENCRYPTION40BIT	Compressione MPPE usando chiavi a 40 bit.
PPP_CCP_ENCRYPTION56BIT	Compressione MPPE usando chiavi a 56 bit.
PPP_CCP_ENCRYPTION128BIT	Compressione MPPE usando chiavi a 128 bit.

Le ultime tre opzioni vengono usate quando viene eseguita una connessione tramite il protocollo L2 Tunneling Protocol (L2TP) e la connessione usa la crittografia IPSec.

dwRemoteCompressionAlgorithm

Valore che specifica l'algoritmo di compressione usato dal server remoto. Sono supportati gli algoritmi seguenti:

Valore	Significato
RASCCPCA_MPPC	Protocollo MPPC (Microsoft Point-to-Point Compression) ( RFC 2118).
RASCCPCA_STAC	Opzione STAC 4 ( RFC 1974).

dwCcpRemoteOptions

Valore che specifica i tipi di compressione disponibili nel server remoto. Sono supportati i tipi seguenti:

Valore	Significato
PPP_CCP_COMPRESSION	Compressione senza crittografia.
PPP_CCP_HISTORYLESS	Crittografia da punto a punto microsoft (MPPE) in modalità senza stato. La chiave di sessione viene modificata dopo ogni pacchetto. Questa modalità migliora le prestazioni in reti a latenza elevata o reti che riscontrano una perdita significativa di pacchetti.
PPP_CCP_ENCRYPTION40BITOLD	Compressione MPPE usando chiavi a 40 bit.
PPP_CCP_ENCRYPTION40BIT	Compressione MPPE usando chiavi a 40 bit.
PPP_CCP_ENCRYPTION56BIT	Compressione MPPE usando chiavi a 56 bit.
PPP_CCP_ENCRYPTION128BIT	Compressione MPPE usando chiavi a 128 bit.
ERROR_PPP_NOT_CONVERGING	Il computer remoto e RRAS non è riuscito a convergere sulla negoziazione degli indirizzi.

Le ultime tre opzioni vengono usate quando viene eseguita una connessione tramite il protocollo L2 Tunneling Protocol (L2TP) e la connessione usa la crittografia IPSec.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Intestazione	mprapi.h

Vedi anche

Informazioni di riferimento sulla gestione dei router

Strutture di gestione router

Condividi tramite

struttura PPP_PROJECTION_INFO (mprapi.h)

Sintassi

Members

Requisiti

Vedi anche

Commenti e suggerimenti

Risorse aggiuntive