Condividi tramite


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

Vedi anche

GetAddrInfoW

Funzioni Winsock

addrinfo

addrinfoW

freeaddrinfo

getaddrinfo