Fonction RtlEthernetAddressToStringA (ip2string.h)

La fonction RtlEthernetAddressToString convertit une adresse Ethernet binaire en une représentation sous forme de chaîne de l’adresse MAC Ethernet.

Syntaxe

NTSYSAPI PSTR RtlEthernetAddressToStringA(
  [in]  const DL_EUI48 *Addr,
  [out] PSTR           S
);

Paramètres

[in] Addr

Adresse Ethernet au format binaire. L’adresse Ethernet est dans l’ordre du réseau (octets classés de gauche à droite).

[out] S

Pointeur vers une mémoire tampon dans laquelle stocker la représentation de chaîne terminée par null de l’adresse Ethernet. Cette mémoire tampon doit être suffisamment grande pour contenir au moins 18 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 MAC Ethernet. Cela peut être utilisé par l’appelant pour ajouter facilement des informations supplémentaires à la chaîne.

Remarques

La fonction RtlEthernetAddressToString est utilisée pour convertir une adresse Ethernet binaire en la représentation sous forme de chaîne de l’adresse Ethernet au format d’adresse de couche de liaison de données Ethernet EUI-48 (également appelé adresse MAC). La chaîne représente une adresse Ethernet numérique exprimée dans la notation « -' » standard non DIX.

La chaîne retournée dans le paramètre S est représentée sous la forme d’une chaîne d’adresse MAC Ethernet dans la notation « - » standard non DIX. La représentation sous forme de chaîne de base d’une adresse MAC Ethernet se compose de 6 paires de nombres hexadécimaux séparés par des tirets (F4-CE-46-2D-90-8C, par exemple).

RtlEthernetAddressToString est une fonction pratique qui ne nécessite pas que la DLL de sockets Windows soit chargée pour accéder à une fonction fournie dans les sockets Windows afin d’effectuer la conversion d’adresses string to Ethernet.

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

Lorsque UNICODE et _UNICODE ne sont pas définis, RtlEthernetAddressToString est défini sur RtlEthernetAddressToStringA, la version ANSI de cette fonction. Le paramètre de chaîne S et la valeur de retour de la fonction sont définis sur le type de données PSTR .

Le type de données DL_EUI48 est défini dans le fichier d’en-tête Mstcpip.h .

Notes

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau | Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau | Applications UWP]
Plateforme cible	Windows
En-tête	ip2string.h (inclure Mstcpip.h, Ip2string.h)
Bibliothèque	ntdll.lib
DLL	ntdll.dll

Voir aussi

RtlEthernetStringToAddress