DeletePersistentUdpPortReservation, fonction (iphlpapi.h)
La fonction DeletePersistentUdpPortReservation supprime une réservation de port TCP persistante pour un bloc consécutif de ports TCP sur l’ordinateur local.
Syntaxe
IPHLPAPI_DLL_LINKAGE ULONG DeletePersistentUdpPortReservation(
[in] USHORT StartPort,
[in] USHORT NumberOfPorts
);
Paramètres
[in] StartPort
Numéro de port UDP de départ dans l’ordre d’octet réseau.
[in] NumberOfPorts
Nombre de numéros de port UDP à supprimer.
Valeur retournée
Si la fonction réussit, la valeur de retour est NO_ERROR.
Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants.
| Code de retour | Description |
|---|---|
|
Accès refusé. Cette erreur est retournée dans plusieurs conditions, notamment : l’utilisateur n’a pas les privilèges d’administration requis sur l’ordinateur local ou l’application ne s’exécute pas dans un interpréteur de commandes amélioré en tant qu’administrateur intégré (administrateur RunAs). |
|
Un paramètre non valide a été transmis à la fonction. Cette erreur est retournée si zéro est passé dans les paramètres StartPort ou NumberOfPorts . |
|
L'élément est introuvable. Cette erreur est retournée si le bloc de port persistant spécifié par les paramètres StartPort et NumberOfPorts est introuvable. |
|
Utilisez FormatMessage pour obtenir la chaîne de message pour l’erreur retournée. |
Notes
La fonction DeletePersistentUdpPortReservation est définie sur Windows Vista et versions ultérieures.
La fonction DeletePersistentUdpPortReservation est utilisée pour supprimer une réservation persistante pour un bloc de ports UDP.
La fonction DeletePersistentUdpPortReservation ne peut être appelée que par un utilisateur connecté en tant que membre du groupe Administrateurs. Si DeletePersistentUdpPortReservation est appelé par un utilisateur qui n’est pas membre du groupe Administrateurs, l’appel de fonction échoue et ERROR_ACCESS_DENIED est retourné. Cette fonction peut également échouer en raison du contrôle de compte d’utilisateur (UAC) sur Windows Vista et versions ultérieures. Si une application qui contient cette fonction est exécutée par un utilisateur connecté en tant que membre du groupe Administrateurs autre que l’administrateur intégré, cet appel échoue, sauf si l’application a été marquée dans le fichier manifeste avec un paramètre requestedExecutionLevel défini sur requireAdministrator. Si l’application ne dispose pas de ce fichier manifeste, un utilisateur connecté en tant que membre du groupe Administrateurs autre que l’administrateur intégré doit alors exécuter l’application dans un interpréteur de commandes amélioré en tant qu’administrateur intégré (administrateur d’exécution) pour que cette fonction réussisse.
Spécifications
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | iphlpapi.h |
| Bibliothèque | Iphlpapi.lib |
| DLL | Iphlpapi.dll |
Voir aussi
CreatePersistentTcpPortReservation
CreatePersistentUdpPortReservation
DeletePersistentTcpPortReservation