Función GetUdp6Table (iphlpapi.h)

Artículo
08/24/2023

La función GetUdp6Table recupera la tabla del agente de escucha del Protocolo de datagramas de usuario (UDP) IPv6.

Sintaxis

IPHLPAPI_DLL_LINKAGE ULONG GetUdp6Table(
  [out]     PMIB_UDP6TABLE Udp6Table,
  [in, out] PULONG         SizePointer,
  [in]      BOOL           Order
);

Parámetros

[out] Udp6Table

Puntero a un búfer que recibe la tabla del agente de escucha UDP de IPv6 como una estructura de MIB_UDP6TABLE .

[in, out] SizePointer

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

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

[in] Order

Valor booleano que especifica si se debe ordenar la tabla de escucha UDP devuelta. Si este parámetro es TRUE, la tabla se ordena en el orden de:

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

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 Udp6Table no es lo suficientemente grande. El tamaño necesario se devuelve en la variable ULONG a la que apunta el parámetro SizePointer .
ERROR_INVALID_PARAMETER	El parámetro SizePointer es NULL o GetUdp6Table 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 GetUdp6Table se define en Windows Vista y versiones posteriores.

Requisitos

Requisito	Value
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