Funzione freeaddrinfo (ws2tcpip.h)
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 |