LookupPersistentUdpPortReservation-Funktion (iphlpapi.h)

Artikel
08/24/2023

Die LookupPersistentUdpPortReservation-Funktion sucht das Token für eine persistente UDP-Portreservierung für einen aufeinanderfolgenden Block von TCP-Ports auf dem lokalen Computer.

Syntax

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

Parameter

[in] StartPort

Die starte UDP-Portnummer in Der Reihenfolge des Netzwerkbytes.

[in] NumberOfPorts

Die Anzahl der reservierten UDP-Portnummern.

[out] Token

Ein Zeiger auf ein Portreservierungstoken, das zurückgegeben wird, wenn die Funktion erfolgreich ist.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.

Rückgabecode	Beschreibung
ERROR_INVALID_PARAMETER	Es wurde ein ungültiger Parameter an die Funktion übergeben. Dieser Fehler wird zurückgegeben, wenn null im StartPort- oder NumberOfPorts-Parameter übergeben wird.
ERROR_NOT_FOUND	Das Element wurde nicht gefunden. Dieser Fehler wird zurückgegeben, wenn der durch die Parameter StartPort und NumberOfPorts angegebene persistente Portblock nicht gefunden werden konnte.
Andere	Verwenden Sie FormatMessage , um die Nachrichtenzeichenfolge für den zurückgegebenen Fehler abzurufen.

Hinweise

Die LookupPersistentUdpPortReservation-Funktion ist unter Windows Vista und höher definiert.

Die LookupPersistentUdpPortReservation-Funktion wird verwendet, um das Token nach einer persistenten Reservierung für einen Block von UDP-Ports zu suchen.

Eine persistente Reservierung für einen Block von UDP-Ports wird durch einen Aufruf der CreatePersistentUdpPortReservation-Funktion erstellt. Die an die Funktion LookupPersistentUdpPortReservation übergebenen Parameter StartPort oder NumberOfPorts müssen mit den Werten übereinstimmen, die verwendet wurden, als die persistente Reservierung für einen Block von TCP-Ports von der CreatePersistentUdpPortReservation-Funktion erstellt wurde.

Wenn die LookupPersistentUdpPortReservation-Funktion erfolgreich ist, zeigt der zurückgegebene Tokenparameter auf das Token für die persistente Portreservierung für den Block der UDP-Ports. Beachten Sie, dass sich das Token für eine bestimmte persistente Reservierung für einen Block von TCP-Ports bei jedem Neustart des Systems ändern kann.

Eine Anwendung kann Portzuweisungen von der UDP-Portreservierung anfordern, indem sie einen UDP-Socket öffnet und dann die WSAIoctl-Funktion aufruft, die die SIO_ASSOCIATE_PORT_RESERVATION IOCTL angibt und das Reservierungstoken übergibt, bevor sie einen Aufruf der Bindungsfunktion auf dem Socket ausgibt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	iphlpapi.h
Bibliothek	Iphlpapi.lib
DLL	Iphlpapi.dll