Funzione GetTcp6Table2 (iphlpapi.h)

Articolo
08/24/2023

La funzione GetTcp6Table2 recupera la tabella di connessione TCP per IPv6.

Sintassi

IPHLPAPI_DLL_LINKAGE ULONG GetTcp6Table2(
  [out]     PMIB_TCP6TABLE2 TcpTable,
  [in, out] PULONG          SizePointer,
  [in]      BOOL            Order
);

Parametri

[out] TcpTable

Puntatore a un buffer che riceve la tabella di connessione TCP per IPv6 come struttura MIB_TCP6TABLE2 .

[in, out] SizePointer

In input, specifica le dimensioni del buffer a cui punta il parametro TcpTable .

Nell'output, se il buffer non è sufficientemente grande da contenere la tabella di connessione TCP restituita, la funzione imposta questo parametro uguale alle dimensioni del buffer necessarie.

[in] Order

Valore che specifica se la tabella di connessione TCP deve essere ordinata. Se questo parametro è TRUE, la tabella viene ordinata in ordine crescente, a partire dall'indirizzo IP locale più basso. Se questo parametro è FALSE, la tabella viene visualizzata nell'ordine in cui sono stati recuperati.

I valori seguenti vengono confrontati (come indicato) quando si ordinano gli endpoint TCP:

Indirizzo IPv6 locale
ID ambito locale
Porta locale
Indirizzo IPv6 remoto
ID ambito remoto
Porta remota

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Codice restituito	Descrizione
ERROR_INSUFFICIENT_BUFFER	Il buffer a cui punta il parametro TcpTable non è sufficiente. La dimensione richiesta viene restituita nella variabile a cui punta il parametro SizePointer .
ERROR_INVALID_PARAMETER	Il parametro SizePointer è NULL oppure GetTcp6Table2 non è in grado di scrivere nella memoria a cui punta il parametro SizePointer .
ERROR_NOT_SUPPORTED	Questa funzione non è supportata nel sistema operativo in uso nel sistema locale.
Altri	Usare FormatMessage per ottenere la stringa del messaggio per l'errore restituito.

Commenti

La funzione GetTcp6Table2 è definita in Windows Vista e versioni successive.

La funzione GetTcp6Table2 è una versione avanzata della funzione GetTcp6Table che recupera anche informazioni sullo stato di offload TCP della connessione TCP.

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	iphlpapi.h
Libreria	Iphlpapi.lib
DLL	Iphlpapi.dll