Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
|---|---|
|
Es wurde ein ungültiger Parameter an die Funktion übergeben. Dieser Fehler wird zurückgegeben, wenn null im StartPort- oder NumberOfPorts-Parameter übergeben wird. |
|
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. |
|
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 |
Weitere Informationen
CreatePersistentTcpPortReservation
CreatePersistentUdpPortReservation
DeletePersistentTcpPortReservation
DeletePersistentUdpPortReservation