Funzione LookupPersistentUdpPortReservation (iphlpapi.h)

Articolo
08/24/2023

La funzione LookupPersistentUdpPortReservation cerca il token per una prenotazione di porta UDP persistente per un blocco consecutivo di porte TCP nel computer locale.

Sintassi

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

Parametri

[in] StartPort

Numero di porta UDP iniziale nell'ordine dei byte di rete.

[in] NumberOfPorts

Numero di numeri di porta UDP riservati.

[out] Token

Puntatore a un token di prenotazione della porta restituito se la funzione ha esito positivo.

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_INVALID_PARAMETER	Alla funzione è stato passato un parametro non valido. Questo errore viene restituito se zero viene passato nei parametri StartPort o NumberOfPorts .
ERROR_NOT_FOUND	Impossibile trovare l'elemento. Questo errore viene restituito se non è stato possibile trovare il blocco di porte persistente specificato dai parametri StartPort e NumberOfPorts .
Altri	Usare FormatMessage per ottenere la stringa del messaggio per l'errore restituito.

Commenti

La funzione LookupPersistentUdpPortReservation viene definita in Windows Vista e versioni successive.

La funzione LookupPersistentUdpPortReservation viene usata per cercare il token per una prenotazione permanente per un blocco di porte UDP.

Una prenotazione permanente per un blocco di porte UDP viene creata da una chiamata alla funzione CreatePersistentUdpPortReservation . I parametri StartPort o NumberOfPorts passati alla funzione LookupPersistentUdpPortReservation devono corrispondere ai valori usati quando la prenotazione permanente per un blocco di porte TCP è stata creata dalla funzione CreatePersistentUdpPortReservation .

Se la funzione LookupPersistentUdpPortReservation ha esito positivo, il parametro Token restituito punterà al token per la prenotazione della porta persistente per il blocco di porte UDP. Si noti che il token per una determinata prenotazione permanente per un blocco di porte TCP può cambiare ogni volta che il sistema viene riavviato.

Un'applicazione può richiedere assegnazioni di porta dalla prenotazione della porta UDP aprendo un socket UDP, quindi chiamando la funzione WSAIoctl specificando il SIO_ASSOCIATE_PORT_RESERVATION IOCTL e passando il token di prenotazione prima di inviare una chiamata alla funzione di associazione sul socket.

Requisiti

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