Fonction RtlIpv4AddressToStringA (ip2string.h)

Article
11/20/2024

La fonction RtlIpv4AddressToString convertit une adresse IPv4 en chaîne au format décimal standard Internet.

Syntaxe

NTSYSAPI PSTR RtlIpv4AddressToStringA(
  [in]  const in_addr *Addr,
  [out] PSTR          S
);

Paramètres

[in] Addr

Adresse IPv4 dans l’ordre d’octet réseau.

[out] S

Pointeur vers une mémoire tampon dans laquelle stocker la NULLreprésentation sous forme de chaîne terminée par l’adresse IPv4. Cette mémoire tampon doit être suffisamment grande pour contenir au moins 16 caractères.

Valeur de retour

Pointeur vers le caractère NULL inséré à la fin de la représentation sous forme de chaîne de l’adresse IPv4. Cela peut être utilisé par l’appelant pour ajouter facilement plus d’informations à la chaîne.

Remarques

La fonction RtlIpv4AddressToString est utilisée pour convertir une adresse IPv4 en représentation sous forme de chaîne de l’adresse IPv4 au format décimal en pointillés Internet.

RtlIpv4AddressToString 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 conversion d’adresse IP en chaîne.

Lorsque unicode ou _UNICODE est défini, RtlIpv4AddressToString est défini sur RtlIpv4AddressToStringW, la version Unicode de cette fonction. Le paramètre de chaîne S et la valeur de retour de fonction sont définies sur le type de données PWSTR.

Quand unicode et _UNICODE ne sont pas définis, RtlIpv4AddressToString est défini sur RtlIpv4AddressToStringA, 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 IN_ADDR est définie dans le fichier d’en-tête inaddr.h .

Une bibliothèque d’importation contenant la fonction RtlIpv4AddressToString n’est pas incluse dans le Kit de développement logiciel Microsoft Windows (SDK) publié pour Windows Vista. La fonction RtlIpv4AddressToString est incluse dans la bibliothèque d’importation Ntdll.lib incluse dans le Kit de pilotes Windows (WDK). Une application peut également utiliser les fonctions GetModuleHandle et GetProcAddress pour récupérer le pointeur de fonction à partir du Ntdll.dll et appeler cette fonction.

Note

L’en-tête ip2string.h définit RtlIpv4AddressToString 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau \| Applications UWP]
serveur minimum pris en charge	Windows Server 2008 [applications de bureau \| Applications UWP]
plateforme cible	Windows
d’en-tête	ip2string.h (include Mstcpip.h, Ip2string.h)
bibliothèque	ntdll.lib
DLL	ntdll.dll