Funzione FreeAddrInfoExW (ws2tcpip.h)
La funzione FreeAddrInfoEx libera le informazioni sull'indirizzo che la funzione GetAddrInfoEx alloca dinamicamente nelle strutture addrinfoex .
Sintassi
void WSAAPI FreeAddrInfoExW(
[in] PADDRINFOEXW pAddrInfoEx
);
Parametri
[in] pAddrInfoEx
Puntatore alla struttura addrinfoex o all'elenco collegato di strutture addrinfoex da liberare. Tutte le risorse di archiviazione dinamiche puntate all'interno della struttura o delle strutture addrinfoex vengono liberate.
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 i buffer a cui puntano i membri della struttura, quindi continua a liberare eventuali strutture addrinfoex collegate dal ai_next membro della struttura addrinfoex. La funzione FreeAddrInfoEx continua a liberare strutture collegate finché non viene rilevato un membro null ai_next.
Quando viene definito UNICODE o _UNICODE, FreeAddrInfoEx viene definito in FreeAddrInfoExW, la versione Unicode della funzione e ADDRINFOEX viene definita alla struttura addrinfoexW. Quando UNICODE o _UNICODE non è definito, FreeAddrInfoEx viene definito in FreeAddrInfoExA, la versione ANSI della funzione e ADDRINFOEX viene definita alla 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.
Nota
L'intestazione ws2tcpip.h definisce FreeAddrInfoEx 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 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 |