Funzione DeletePersistentUdpPortReservation (iphlpapi.h)
La funzione DeletePersistentUdpPortReservation elimina una prenotazione di porta TCP persistente per un blocco consecutivo di porte TCP nel computer locale.
Sintassi
IPHLPAPI_DLL_LINKAGE ULONG DeletePersistentUdpPortReservation(
[in] USHORT StartPort,
[in] USHORT NumberOfPorts
);
Parametri
[in] StartPort
Numero di porta UDP iniziale nell'ordine dei byte di rete.
[in] NumberOfPorts
Numero di numeri di porta UDP da eliminare.
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 |
|---|---|
|
Accesso negato. Questo errore viene restituito in diverse condizioni che includono quanto segue: l'utente non dispone dei privilegi amministrativi necessari nel computer locale o l'applicazione non è in esecuzione in una shell avanzata come amministratore predefinito (amministratore RunAs). |
|
Alla funzione è stato passato un parametro non valido. Questo errore viene restituito se zero viene passato nei parametri StartPort o NumberOfPorts . |
|
Impossibile trovare l'elemento. Questo errore viene restituito se non è stato possibile trovare il blocco di porte persistente specificato dai parametri StartPort e NumberOfPorts . |
|
Usare FormatMessage per ottenere la stringa del messaggio per l'errore restituito. |
Commenti
La funzione DeletePersistentUdpPortReservation viene definita in Windows Vista e versioni successive.
La funzione DeletePersistentUdpPortReservation viene usata per eliminare una prenotazione permanente per un blocco di porte UDP.
La funzione DeletePersistentUdpPortReservation può essere chiamata solo da un utente connesso come membro del gruppo Administrators. Se DeletePersistentUdpPortReservation viene chiamato da un utente che non è membro del gruppo Administrators, la chiamata di funzione avrà esito negativo e ERROR_ACCESS_DENIED viene restituito. Questa funzione può anche non riuscire a causa del controllo dell'account utente in Windows Vista e versioni successive. Se un'applicazione che contiene questa funzione viene eseguita da un utente connesso come membro del gruppo Administrators diverso dall'amministratore predefinito, questa chiamata avrà esito negativo a meno che l'applicazione non sia stata contrassegnata nel file manifesto con un set requestedExecutionLevel impostato su requireAdministrator. Se l'applicazione non dispone di questo file manifesto, un utente connesso come membro del gruppo Administrators diverso dall'amministratore predefinito deve quindi eseguire l'applicazione in una shell avanzata come amministratore predefinito (amministratore RunAs) affinché questa funzione abbia esito positivo.
Requisiti
| 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 |
Vedi anche
CreatePersistentTcpPortReservation
CreatePersistentUdpPortReservation
DeletePersistentTcpPortReservation