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 réseau (octets classés de gauche à droite).
[out] S
Pointeur vers une mémoire tampon dans laquelle stocker la NULL-terminated string représentation of the Ethernet address. Cette mémoire tampon doit être suffisamment grande pour contenir au moins 18 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 MAC Ethernet. Cela peut être utilisé par l’appelant pour ajouter facilement plus d’informations à la chaîne.
Remarques
La fonction RtlEthernetAddressToString est utilisée pour convertir une adresse Ethernet binaire en représentation sous forme de chaîne de l’adresse Ethernet au format d’adresse de liaison de données EUI-48 Ethernet (également appelée adresse MAC). La chaîne représente une adresse Ethernet numérique exprimée en notation non DIX standard « - ».
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 « - » non DIX standard. 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 Windows Sockets soit chargée pour accéder à une fonction fournie dans Windows Sockets pour effectuer la conversion d’adresses Ethernet.
Quand 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 fonction sont définies 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
Le type de données DL_EUI48 est défini dans le fichier d’en-tête Mstcpip.h.
Note
L’en-tête ip2string.h définit RtlEthernetAddressToString comme 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 7 [applications de bureau | Applications UWP] |
| serveur minimum pris en charge | Windows Server 2008 R2 [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 |