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

Vedi anche

GetAddrInfoEx

addrinfoex