Funzione RtlIpv4AddressToStringA (ip2string.h)

Articolo
11/20/2024

La funzione RtlIpv4AddressToString converte un indirizzo IPv4 in una stringa in formato decimale tratteggiato standard di Internet.

Sintassi

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

Parametri

[in] Addr

Indirizzo IPv4 nell'ordine dei byte di rete.

[out] S

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

Valore restituito

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

Osservazioni

La funzione RtlIpv4AddressToString viene usata per convertire un indirizzo IPv4 nella rappresentazione di stringa dell'indirizzo IPv4 in formato decimale tratteggiato da Internet.

RtlIpv4AddressToString è 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 dell'indirizzo IP alla stringa.

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

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

La struttura IN_ADDR è definita nel file di intestazione Inaddr. h.

Una libreria di importazione contenente il funzione RtlIpv4AddressToString non è inclusa nel Microsoft Windows Software Development Kit (SDK) rilasciato per Windows Vista. La funzione RtlIpv4AddressToString è inclusa nella libreria ntdll.lib inclusa in Windows Driver Kit (WDK). Un'applicazione può anche usare le funzioni GetModuleHandle e GetProcAddress per recuperare il puntatore di funzione dal Ntdll.dll e chiamare questa funzione.

Nota

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