struttura RASIKEV2_PROJECTION_INFO (ras.h)

Articolo
03/01/2024

La struttura RASIKEV2_PROJECTION_INFO contiene informazioni di proiezione ottenute durante la negoziazione IKE (Internet Key Exchange).

Sintassi

typedef struct _RASIKEV2_PROJECTION_INFO {
  DWORD       dwIPv4NegotiationError;
  RASIPV4ADDR ipv4Address;
  RASIPV4ADDR ipv4ServerAddress;
  DWORD       dwIPv6NegotiationError;
  RASIPV6ADDR ipv6Address;
  RASIPV6ADDR ipv6ServerAddress;
  DWORD       dwPrefixLength;
  DWORD       dwAuthenticationProtocol;
  DWORD       dwEapTypeId;
  DWORD       dwFlags;
  DWORD       dwEncryptionMethod;
  DWORD       numIPv4ServerAddresses;
  RASIPV4ADDR *ipv4ServerAddresses;
  DWORD       numIPv6ServerAddresses;
  RASIPV6ADDR *ipv6ServerAddresses;
} RASIKEV2_PROJECTION_INFO, *PRASIKEV2_PROJECTION_INFO;

Members

dwIPv4NegotiationError

Valore che specifica il risultato della negoziazione IPv4. Il valore zero indica che è stato assegnato correttamente un indirizzo IPv4. Un valore diverso da zero indica un errore ed è l'errore irreversibile che si è verificato durante la negoziazione.

ipv4Address

Struttura RASIPV4ADDR che contiene una stringa Unicode con terminazione Null che specifica l'indirizzo IPv4 del client locale. Questa stringa ha il formato "a.b.c.d". ipv4Address è valido solo se dwIPv4NegotiationError è zero.

ipv4ServerAddress

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

dwIPv6NegotiationError

Valore che specifica il risultato della negoziazione IPv6. Il valore zero indica che un indirizzo IPv6 è stato negoziato correttamente. Un valore diverso da zero indica un errore ed è l'errore irreversibile che si è verificato durante la negoziazione.

ipv6Address

Struttura RASIPV6ADDR che contiene una stringa Unicode con terminazione Null che specifica l'indirizzo IPv6 del client locale. ipv6Address è valido solo se dwIPv6NegotiationError è zero.

ipv6ServerAddress

Struttura RASIPV6ADDR che contiene una stringa Unicode con terminazione Null che specifica l'indirizzo IPv6 del server remoto. ipv6ServerAddress è valido solo se dwIPv6NegotiationError è zero. Se l'indirizzo non è disponibile, questo membro è una stringa vuota.

dwPrefixLength

Valore che specifica la lunghezza, in bit, del prefisso dell'indirizzo IPv6.

dwAuthenticationProtocol

Valore che specifica il protocollo di autenticazione utilizzato per autenticare il server remoto. Sono supportati i protocolli di autenticazione seguenti:

Valore	Significato
RASIKEv2_AUTH_MACHINECERTIFICATES	Certificato dell'infrastruttura a chiave pubblica X.509 (RFC 2459).
RASIKEv2_AUTH_EAP	Extensible Authentication Protocol.

dwEapTypeId

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

dwFlags

Bitmap di flag che può essere qualsiasi combinazione dei valori seguenti:

Valore	Significato
RASIKEv2_FLAGS_MOBIKESUPPORTED	Il client supporta Mobile IKE (MOBIKE).
RASIKEv2_FLAGS_BEHIND_NAT	Il client si trova dietro NAT (Network Address Translation).
RASIKEv2_FLAGS_SERVERBEHIND_NAT	Il server si trova dietro NAT (Network Address Translation).

dwEncryptionMethod

Valore che specifica il metodo di crittografia utilizzato nella connessione. Sono supportati i metodi di crittografia seguenti:

Valore	Significato
IPSEC_CIPHER_TYPE_3DES	Crittografia 3DES.
IPSEC_CIPHER_TYPE_AES_128	Crittografia AES-128.
IPSEC_CIPHER_TYPE_AES_192	Crittografia AES-192.
IPSEC_CIPHER_TYPE_AES_256	Crittografia AES-256.

numIPv4ServerAddresses

Il numero di indirizzi IPv4 disponibili a cui il server può passare sulla connessione IKEv2.

ipv4ServerAddresses

Puntatore a una struttura RASIPV4ADDR che contiene gli indirizzi IPv4 disponibili a cui il server può passare sulla connessione IKEv2.

numIPv6ServerAddresses

Numero di indirizzi IPv6 disponibili a cui il server può passare sulla connessione IKEv2.

ipv6ServerAddresses

Puntatore a una struttura RASIPV6ADDR che contiene gli indirizzi IPv6 disponibili a cui il server può passare sulla connessione IKEv2.

Requisiti

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

Vedi anche

RASPROJECTION_INFO_TYPE

Panoramica del servizio accesso remoto (RAS)

Strutture del servizio accesso remoto

Condividi tramite