Compartir a través de


Función LookupPersistentUdpPortReservation (iphlpapi.h)

La función LookupPersistentUdpPortReservation busca el token de una reserva de puerto UDP persistente para un bloque consecutivo de puertos TCP en el equipo local.

Sintaxis

IPHLPAPI_DLL_LINKAGE ULONG LookupPersistentUdpPortReservation(
  [in]  USHORT   StartPort,
  [in]  USHORT   NumberOfPorts,
  [out] PULONG64 Token
);

Parámetros

[in] StartPort

Número de puerto UDP inicial en orden de bytes de red.

[in] NumberOfPorts

Número de números de puerto UDP reservados.

[out] Token

Puntero a un token de reserva de puerto que se devuelve si la función se realiza correctamente.

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_INVALID_PARAMETER
Se pasó un parámetro no válido a la función. Este error se devuelve si cero se pasa en los parámetros StartPort o NumberOfPorts .
ERROR_NOT_FOUND
No se encontró el elemento. Este error se devuelve si no se encontró ningún bloque de puerto persistente especificado por los parámetros StartPort y NumberOfPorts .
Otros
Use FormatMessage para obtener la cadena de mensaje para el error devuelto.

Comentarios

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

La función LookupPersistentUdpPortReservation se usa para buscar el token de una reserva persistente para un bloque de puertos UDP.

Una reserva persistente para un bloque de puertos UDP se crea mediante una llamada a la función CreatePersistentUdpPortReservation . Los parámetros StartPort o NumberOfPorts pasados a la función LookupPersistentUdpPortReservation deben coincidir con los valores usados cuando la función CreatePersistentUdpPortReservation creó la reserva persistente para un bloque de puertos TCP.

Si la función LookupPersistentUdpPortReservation se realiza correctamente, el parámetro Token devuelto apuntará al token para la reserva de puerto persistente para el bloque de puertos UDP. Tenga en cuenta que el token de una reserva persistente determinada para un bloque de puertos TCP puede cambiar cada vez que se reinicia el sistema.

Una aplicación puede solicitar asignaciones de puerto desde la reserva de puertos UDP abriendo un socket UDP y llamando a la función WSAIoctl especificando el IOCTL de SIO_ASSOCIATE_PORT_RESERVATION y pasando el token de reserva antes de emitir una llamada a la función bind en el socket.

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

Consulte también

CreatePersistentTcpPortReservation

CreatePersistentUdpPortReservation

DeletePersistentTcpPortReservation

DeletePersistentUdpPortReservation

LookupPersistentTcpPortReservation

SIO_ASSOCIATE_PORT_RESERVATION