Funzione FreeAddrInfoW (ws2tcpip.h)

Articolo
11/20/2024

La funzione FreeAddrInfoW libera le informazioni sull'indirizzo allocate in modo dinamico dalla funzione GetAddrInfoW in 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. Viene liberata anche tutta la risorsa di archiviazione dinamica a cui punta all'interno del addrinfoW struttura o strutture.

Valore restituito

Questa funzione non restituisce un valore.

Osservazioni

La funzione FreeAddrInfoW libera strutture addrinfoW allocate dinamicamente dalla funzione GetAddrInfoW Unicode . La funzione FreeAddrInfoW libera la struttura addrinfoW iniziale a cui punta il parametro pAddrInfo, inclusi eventuali buffer a cui puntano i membri della struttura, quindi continua a liberare tutte le strutture addrinfoW collegate dal membro ai_next della struttura addrinfoW. La funzione FreeAddrInfoW continua a liberare strutture collegate fino a quando non viene rilevato un membroai_next NULL .

Le macro nel file di intestazione Winsock definiscono un nome di funzione con maiuscole e minuscole 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 per FreeAddrInfoW, la versione Unicode della funzione e ADDRINFOT viene definita alla struttura addrinfoW . Quando UNICODE o _UNICODE non è definito, FreeAddrInfo viene definito per freeaddrinfo, la versione ANSI della funzione e ADDRINFOT viene definita alla 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

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	Finestre
intestazione	ws2tcpip.h
libreria	Ws2_32.lib
dll	Ws2_32.dll