Funzione RtlEthernetAddressToStringW (ip2string.h)

Articolo
11/20/2024

La funzione RtlEthernetAddressToString converte un indirizzo Ethernet binario in una rappresentazione di stringa dell'indirizzo MAC Ethernet.

Sintassi

NTSYSAPI PWSTR RtlEthernetAddressToStringW(
  [in]  const DL_EUI48 *Addr,
  [out] PWSTR          S
);

Parametri

[in] Addr

Indirizzo Ethernet in formato binario. L'indirizzo Ethernet è in ordine di rete (byte ordinati da sinistra a destra).

[out] S

Puntatore a un buffer in cui archiviare il NULLrappresentazione di stringa con terminazione dell'indirizzo Ethernet. Questo buffer deve essere sufficientemente grande da contenere almeno 18 caratteri.

Valore restituito

Puntatore al carattere NULL inserito alla fine della rappresentazione di stringa dell'indirizzo MAC Ethernet. Questa operazione può essere usata dal chiamante per aggiungere facilmente altre informazioni alla stringa.

Osservazioni

La funzione RtlEthernetAddressToString viene usata per convertire un indirizzo Ethernet binario nella rappresentazione di stringa dell'indirizzo Ethernet in formato di indirizzo del livello di collegamento dati Ethernet EUI-48 (noto anche come indirizzo MAC). La stringa rappresenta un indirizzo Ethernet numerico espresso nella notazione standard non DIX "-'' .

La stringa restituita nel parametro S è rappresentata nel formato per una stringa di indirizzo MAC Ethernet nella notazione "-" standard non DIX. La rappresentazione di stringa di base di un indirizzo MAC Ethernet è costituita da 6 coppie di numeri esadecimali separati da trattini (ad esempio F4-CE-46-2D-90-8C).

RtlEthernetAddressToString è 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 della stringa nell'indirizzo Ethernet.

Quando viene definito UNICODE o _UNICODE, RtlEthernetAddressToString viene definito per RtlEthernetAddressToStringW, la versione Unicode di questa funzione. Il parametro stringa S e il valore restituito della funzione vengono definiti al tipo di dati PWSTR .

Quando sia UNICODE che _UNICODE non sono definiti, RtlEthernetAddressToString viene definito per RtlEthernetAddressToStringA, la versione ANSI di questa funzione. Il parametro stringa S e il valore restituito della funzione vengono definiti al tipo di dati PSTR .

Il tipo di dati DL_EUI48 è definito nel file di intestazione Mstcpip. h.

Nota

L'intestazione ip2string.h definisce RtlEthernetAddressToString 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 7 [app desktop \| App UWP]
server minimo supportato	Windows Server 2008 R2 [app desktop \| App UWP]
piattaforma di destinazione	Finestre
intestazione	ip2string.h (include Mstcpip.h, Ip2string.h)
libreria	ntdll.lib
dll	ntdll.dll

Vedere anche

RtlEthernetStringToAddress

Condividi tramite