Funzione FreeAddrInfoEx (ws2tcpip.h)
La funzione FreeAddrInfoEx libera le informazioni sull'indirizzo allocate dinamicamente dalla funzione GetAddrInfoEx nelle strutture addrinfoex .
Sintassi
void WSAAPI FreeAddrInfoEx(
[in] PADDRINFOEXA pAddrInfoEx
);
Parametri
[in] pAddrInfoEx
Puntatore alla struttura addrinfoex o all'elenco collegato di strutture addrinfoex da liberare. Viene liberata anche tutta l'archiviazione dinamica a cui punta all'interno della struttura o delle strutture addrinfoex .
Valore restituito
Questa funzione non restituisce un valore.
Commenti
La funzione FreeAddrInfoEx libera le strutture addrinfoex allocate dinamicamente dalla funzione GetAddrInfoEx . La funzione FreeAddrInfoEx libera la struttura addrinfoex iniziale a cui punta il parametro pAddrInfo , inclusi eventuali buffer a cui puntano i membri della struttura, quindi continua a liberare tutte le strutture addrinfoex collegate dal membro ai_next della struttura addrinfoex . La funzione FreeAddrInfoEx continua a liberare strutture collegate finché non viene rilevato un membro ai_nextNULL.
Quando si definisce UNICODE o _UNICODE, FreeAddrInfoEx viene definito in FreeAddrInfoExW, la versione Unicode della funzione e ADDRINFOEX viene definita per la struttura addrinfoexW . Quando UNICODE o _UNICODE non è definito, FreeAddrInfoEx viene definito in FreeAddrInfoExA, la versione ANSI della funzione e ADDRINFOEX viene definita per la struttura addrinfoexA .
Windows 8.1 e Windows Server 2012 R2: la funzione FreeAddrInfoExW è supportata 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 2008 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | ws2tcpip.h |
| Libreria | Ws2_32.lib |
| DLL | Ws2_32.dll |