Funzione RtlEthernetAddressToStringA (ip2string.h)
La funzione RtlEthernetAddressToString converte un indirizzo Ethernet binario in una rappresentazione di stringa dell'indirizzo MAC Ethernet.
Sintassi
NTSYSAPI PSTR RtlEthernetAddressToStringA(
[in] const DL_EUI48 *Addr,
[out] PSTR 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 la rappresentazione di stringa con terminazione NULL dell'indirizzo Ethernet. Questo buffer deve essere abbastanza grande per contenere almeno 18 caratteri.
Valore restituito
Puntatore al carattere NULL inserito alla fine della rappresentazione stringa dell'indirizzo MAC Ethernet. Questa operazione può essere usata dal chiamante per aggiungere facilmente altre informazioni alla stringa.
Commenti
La funzione RtlEthernetAddressToString viene usata per convertire un indirizzo Ethernet binario nella rappresentazione di stringa dell'indirizzo Ethernet in formato di indirizzo eui-48 del livello di collegamento dati (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 di praticità che non richiede che la DLL di Windows Sockets venga caricata per accedere a una funzione fornita in Windows Sockets per eseguire la conversione della stringa all'indirizzo Ethernet.
Quando viene definito UNICODE o _UNICODE, RtlEthernetAddressToString viene definito in RtlEthernetAddressToStringW, la versione Unicode di questa funzione. Il parametro stringa S e il valore restituito dalla funzione sono definiti per il tipo di dati PWSTR .
Quando sia UNICODE che _UNICODE non sono definiti, RtlEthernetAddressToString viene definito in RtlEthernetAddressToStringA, la versione ANSI di questa funzione. Il parametro stringa S e il valore restituito della funzione sono definiti per il 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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| 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 | Windows |
| Intestazione | ip2string.h (includere Mstcpip.h, Ip2string.h) |
| Libreria | ntdll.lib |
| DLL | ntdll.dll |