Función GetTcp6Table2 (iphlpapi.h)

Artículo
08/24/2023

La función GetTcp6Table2 recupera la tabla de conexión TCP para IPv6.

Sintaxis

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

Parámetros

[out] TcpTable

Puntero a un búfer que recibe la tabla de conexión TCP para IPv6 como una estructura de MIB_TCP6TABLE2 .

[in, out] SizePointer

En la entrada, especifica el tamaño del búfer al que apunta el parámetro TcpTable .

En la salida, si el búfer no es lo suficientemente grande como para contener la tabla de conexión TCP devuelta, la función establece este parámetro igual al tamaño de búfer necesario.

[in] Order

Valor que especifica si se debe ordenar la tabla de conexión TCP. Si este parámetro es TRUE, la tabla se ordena en orden ascendente, empezando por la dirección IP local más baja. Si este parámetro es FALSE, la tabla aparece en el orden en que se recuperaron.

Los valores siguientes se comparan (como se muestra) al ordenar los puntos de conexión TCP:

Dirección IPv6 local
Identificador de ámbito local
Puerto local
Dirección IPv6 remota
Identificador de ámbito remoto
Puerto remoto

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es NO_ERROR.

Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.

Código devuelto	Descripción
ERROR_INSUFFICIENT_BUFFER	El búfer al que apunta el parámetro TcpTable no es lo suficientemente grande. El tamaño necesario se devuelve en la variable a la que apunta el parámetro SizePointer .
ERROR_INVALID_PARAMETER	El parámetro SizePointer es NULL o GetTcp6Table2 no puede escribir en la memoria a la que apunta el parámetro SizePointer .
ERROR_NOT_SUPPORTED	Esta función no se admite en el sistema operativo en uso en el sistema local.
Otros	Use FormatMessage para obtener la cadena de mensaje para el error devuelto.

Comentarios

La función GetTcp6Table2 se define en Windows Vista y versiones posteriores.

La función GetTcp6Table2 es una versión mejorada de la función GetTcp6Table que también recupera información sobre el estado de descarga TCP de la conexión TCP.

Requisitos


Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	iphlpapi.h
Library	Iphlpapi.lib
Archivo DLL	Iphlpapi.dll