Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
La fonction RtlIpv6AddressToString convertit une adresse IPv6 en chaîne au format standard Internet.
Syntaxe
NTSYSAPI PSTR RtlIpv6AddressToStringA(
[in] const in6_addr *Addr,
[out] PSTR S
);
Paramètres
[in] Addr
Adresse IPv6 dans l’ordre d’octet réseau.
[out] S
Pointeur vers une mémoire tampon dans laquelle stocker la représentation sous forme de chaîne terminée par NULL de l’adresse IPv6. Cette mémoire tampon doit être suffisamment grande pour contenir au moins 46 caractères.
Valeur retournée
Pointeur vers le caractère NULL inséré à la fin de la représentation sous forme de chaîne de l’adresse IPv6. Cela peut être utilisé par l’appelant pour ajouter facilement plus d’informations à la chaîne.
Remarques
La fonction RtlIpv6AddressToString est utilisée pour convertir une adresse IPv6 en représentation sous forme de chaîne de l’adresse IPv6 au format standard Internet.
La représentation sous forme de chaîne de base se compose de 8 nombres hexadécimaux séparés par des points-virgules. Une chaîne de nombres zéro consécutifs est remplacée par un double-signe deux-points. Il ne peut y avoir qu’un double-signe deux-points dans la représentation sous forme de chaîne de l’adresse IPv6. Les 32 derniers bits sont représentés en notation d’octets en pointillés de style IPv4 si l’adresse est une adresse compatible IPv4, une adresse IPv4 mappée à IPv6 ou une adresse ISATAP. Pour plus d’informations, consultez la section 5 de la RFC 5942 publiée par l’IETF.
RtlIpv6AddressToString est une fonction pratique qui ne nécessite pas que la DLL Windows Sockets soit chargée pour accéder à une fonction fournie dans Windows Sockets pour effectuer une adresse IP en conversion de chaîne.
Quand unicode ou _UNICODE est défini, RtlIpv6AddressToString est défini sur RtlIpv6AddressToStringW, la version Unicode de cette fonction. Le paramètre de chaîne S et la valeur de retour de fonction sont définis sur le type de données PWSTR.
Lorsque unicode et _UNICODE ne sont pas définis, RtlIpv6AddressToString est défini sur RtlIpv6AddressToStringA, la version ANSI de cette fonction. Le paramètre de chaîne S et la valeur de retour de fonction sont définis sur le type de données PSTR.
La structure IN6_ADDR est définie dans le fichier d’en-tête In6addr.h .
Note
L’en-tête ip2string.h définit RtlIpv6AddressToString en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Spécifications
| Requirement | Valeur |
|---|---|
| Client minimum requis | Windows Vista [applications de bureau | Applications UWP] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau | Applications UWP] |
| plateforme cible | Fenêtres |
| Header | ip2string.h (include Mstcpip.h, Ip2string.h) |
| Library | ntdll.lib |
| DLL | ntdll.dll |