Funzione freeaddrinfo (ws2tcpip.h)

Articolo
08/28/2023

La funzione freeaddrinfo libera le informazioni sull'indirizzo allocate dinamicamente dalla funzione getaddrinfo nelle strutture addrinfo .

Sintassi

VOID WSAAPI freeaddrinfo(
  [in] PADDRINFOA pAddrInfo
);

Parametri

[in] pAddrInfo

Puntatore alla struttura addrinfo o all'elenco collegato di strutture addrinfo da liberare. Viene liberata anche tutta l'archiviazione dinamica a cui punta all'interno della struttura o delle strutture addrinfo .

Valore restituito

Questa funzione non restituisce un valore.

Commenti

La funzione freeaddrinfo libera strutture addrinfo allocate dinamicamente dalla funzione getaddrinfo ANSI. La funzione freeaddrinfo libera la struttura addrinfo iniziale a cui punta nel parametro ai , inclusi eventuali buffer a cui puntano i membri della struttura, quindi continua a liberare eventuali strutture addrinfo collegate dal membro ai_next della struttura addrinfo . La funzione freeaddrinfo continua a liberare strutture collegate finché non viene rilevato un membro ai_nextNULL.

Le macro nel file di intestazione Winsock definiscono un nome di funzione con maiuscole e minuscole FreeAddrInfo e una struttura ADDRINFOT . Questa funzione FreeAddrInfo deve essere chiamata con il parametro ai di un puntatore di tipo ADDRINFOT. Quando UNICODE o _UNICODE non è definito, FreeAddrInfo viene definito per freeaddrinfo, la versione ANSI della funzione e ADDRINFOT viene definita per la struttura addrinfo . Quando si definisce UNICODE o _UNICODE, FreeAddrInfo viene definito in FreeAddrInfoW, la versione Unicode della funzione e ADDRINFOT viene definita per la struttura addrinfoW .

Supporto per freeaddrinfo nelle versioni precedenti di Windows

La funzione freeaddrinfo è stata aggiunta alla Ws2_32.dll in Windows XP e versioni successive.

La funzione FreeAddrInfoW è la versione Unicode di freeaddrinfo. La funzione FreeAddrInfoW è stata aggiunta alla Ws2_32.dll in Windows XP con Service Pack 2 (SP2). La funzione FreeAddrInfoW non può essere utilizzata nelle versioni di Windows precedenti a Windows XP con SP2.

Windows Phone 8: la funzione freeaddrinfo è supportata per Windows Phone app dello Store in Windows Phone 8 e versioni successive.

Windows 8.1 e Windows Server 2012 R2: le funzioni freeaddrinfo e FreeAddrInfoW sono supportate per le app di Windows Store in Windows 8.1, Windows Server 2012 R2 e versioni successive.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8.1, Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	ws2tcpip.h
DLL	Ws2_32.dll