Funzione RtlIpv6AddressToStringW (ip2string.h)
La funzione RtlIpv6AddressToString
Sintassi
NTSYSAPI PWSTR RtlIpv6AddressToStringW(
[in] const in6_addr *Addr,
[out] PWSTR S
);
Parametri
[in] Addr
Indirizzo IPv6 nell'ordine dei byte di rete.
[out] S
Puntatore a un buffer in cui archiviare il NULLrappresentazione di stringa con terminazione dell'indirizzo IPv6. Questo buffer deve essere sufficientemente grande da contenere almeno 46 caratteri.
Valore restituito
Puntatore al carattere NULL inserito alla fine della rappresentazione di stringa dell'indirizzo IPv6. Questa operazione può essere usata dal chiamante per aggiungere facilmente altre informazioni alla stringa.
Osservazioni
La funzione RtlIpv6AddressToString viene usata per convertire un indirizzo IPv6 nella rappresentazione di stringa dell'indirizzo IPv6 in formato Standard Internet.
La rappresentazione di stringa di base è costituita da 8 numeri esadecimali separati da due punti. Una stringa di numeri zero consecutivi viene sostituita con due due punti. Nella rappresentazione di stringa dell'indirizzo IPv6 può essere presente un solo doppio due punti. Gli ultimi 32 bit sono rappresentati nella notazione IPv4 punteggiata-ottet se l'indirizzo è un indirizzo compatibile con IPv4, un indirizzo IPv4 mappato a IPv6 o un indirizzo ISATAP. Per altre informazioni, vedere la sezione 5 di RFC 5942 pubblicata da IETF.
RtlIpv6AddressToString è una funzione utile che non richiede il caricamento della DLL di Windows Sockets per accedere a una funzione fornita in Windows Sockets per eseguire la conversione dell'indirizzo IP alla stringa.
Quando viene definito UNICODE o _UNICODE, RtlIpv6AddressToString viene definito per RtlIpv6AddressToStringW, la versione Unicode di questa funzione. Il parametro stringa S e il valore restituito della funzione vengono definiti per il tipo di dati PWSTR.
Quando sia UNICODE che _UNICODE non sono definiti, RtlIpv6AddressToString viene definito per RtlIpv6AddressToStringA, la versione ANSI di questa funzione. Il parametro stringa S e il valore restituito della funzione sono definiti per il tipo di dati PSTR.
La struttura IN6_ADDR viene definita nel file di intestazione In6addr.h.
Una libreria di importazione contenente il funzione RtlIpv6AddressToString non è inclusa nella versione di Microsoft Windows Software Development Kit (SDK) per Windows Vista. La funzione di RtlIpv6AddressToString è inclusa nella ntdll.lib libreria di importazione inclusa in Windows Driver Kit (WDK). Un'applicazione può anche usare le funzioni GetModuleHandle e GetProcAddress per recuperare il puntatore di funzione dal Ntdll.dll e chiamare questa funzione.
Nota
L'intestazione ip2string.h definisce RtlIpv6AddressToString come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista [app desktop | App UWP] |
| server minimo supportato | Windows Server 2008 [app desktop | App UWP] |
| piattaforma di destinazione | Finestre |
| intestazione |
ip2string.h (include Mstcpip.h, Ip2string.h) |
| libreria |
ntdll.lib |
| dll | ntdll.dll |