Funzione FreeAddrInfoW (ws2tcpip.h)
La funzione FreeAddrInfoW libera le informazioni sull'indirizzo che la funzione GetAddrInfoW alloca dinamicamente nelle strutture addrinfoW .
Sintassi
VOID WSAAPI FreeAddrInfoW(
[in] PADDRINFOW pAddrInfo
);
Parametri
[in] pAddrInfo
Puntatore alla struttura addrinfoW o all'elenco collegato di strutture addrinfoW da liberare. Tutte le risorse di archiviazione dinamiche puntate all'interno della struttura o delle strutture addrinfoW vengono liberate.
Valore restituito
Questa funzione non restituisce un valore.
Commenti
La funzione FreeAddrInfoW libera le strutture addrinfoW allocate dinamicamente dalla funzione Unicode GetAddrInfoW . La funzione FreeAddrInfoW libera la struttura addrinfoW iniziale a cui punta il parametro pAddrInfo, inclusi i buffer a cui puntano i membri della struttura, quindi continua a liberare eventuali strutture addrinfoW collegate dal membro ai_next della struttura addrinfoW. La funzione FreeAddrInfoW continua a liberare strutture collegate finché non viene rilevato un membro nullai_next .
Le macro nel file di intestazione Winsock definiscono un nome di funzione mixed-case di FreeAddrInfo e una struttura ADDRINFOT . Questa funzione FreeAddrInfo deve essere chiamata con il parametro pAddrInfo di un puntatore di tipo ADDRINFOT. Quando viene definito UNICODE o _UNICODE, FreeAddrInfo viene definito in FreeAddrInfoW, la versione Unicode della funzione e ADDRINFOT viene definita alla struttura addrinfoW. Quando UNICODE o _UNICODE non è definito, FreeAddrInfo è definito per freeaddrinfo, la versione ANSI della funzione e ADDRINFOT viene definita per la struttura addrinfo .
Windows 8.1 e Windows Server 2012 R2: questa funzione è supportata per le app di Windows Store in Windows 8.1, Windows Server 2012 R2 e versioni successive.
Nota
L'intestazione ws2tcpip.h definisce FreeAddrInfo 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 2003 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | ws2tcpip.h |
| Libreria | Ws2_32.lib |
| DLL | Ws2_32.dll |