Funzione DeleteService (winsvc.h)

Articolo
03/13/2024

Contrassegna il servizio specificato per l'eliminazione dal database di Gestione controllo dei servizi.

Sintassi

BOOL DeleteService(
  [in] SC_HANDLE hService
);

Parametri

[in] hService

Handle per il servizio. Questo handle viene restituito dalla funzione OpenService o CreateService e deve avere il diritto di accesso DELETE. Per altre informazioni, vedere Sicurezza del servizio e diritti di accesso.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

I codici di errore seguenti possono essere impostati dal gestore di controllo del servizio. Altri possono essere impostati dalle funzioni del Registro di sistema chiamate dal gestore di controllo del servizio.

Codice restituito	Descrizione
ERROR_ACCESS_DENIED	L'handle non dispone del diritto di accesso DELETE.
ERROR_INVALID_HANDLE	L'handle specificato non è valido.
ERROR_SERVICE_MARKED_FOR_DELETE	Il servizio specificato è già stato contrassegnato per l'eliminazione.

Commenti

La funzione DeleteService contrassegna un servizio per l'eliminazione dal database di Gestione controllo servizi. La voce di database non viene rimossa finché tutti gli handle aperti al servizio non sono stati chiusi dalle chiamate alla funzione CloseServiceHandle e il servizio non è in esecuzione. Un servizio in esecuzione viene arrestato da una chiamata alla funzione ControlService con il codice di controllo SERVICE_CONTROL_STOP. Se il servizio non può essere arrestato, la voce del database viene rimossa al riavvio del sistema.

Gestione controllo del servizio elimina il servizio eliminando la chiave del servizio e le relative sottochiavi dal Registro di sistema.

Esempio

Per un esempio, vedere Eliminazione di un servizio.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winsvc.h (include Windows.h)
Libreria	Advapi32.lib
DLL	Advapi32.dll