Compartir a través de


Función GetTcp6Table2 (iphlpapi.h)

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:

  1. Dirección IPv6 local
  2. Identificador de ámbito local
  3. Puerto local
  4. Dirección IPv6 remota
  5. Identificador de ámbito remoto
  6. 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

Consulte también

GetExtendedTcpTable

GetOwnerModuleFromTcp6Entry

GetTcp6Table

GetTcpStatisticsEx

GetTcpTable

MIB_TCP6ROW

MIB_TCP6ROW2

MIB_TCP6ROW_OWNER_MODULE

MIB_TCP6ROW_OWNER_PID

MIB_TCP6TABLE

MIB_TCP6TABLE2

MIB_TCP6TABLE_OWNER_MODULE

MIB_TCP6TABLE_OWNER_PID