Funzione CloseServiceHandle (winsvc.h)

Articolo
03/04/2024

Chiude un handle a un gestore di controllo del servizio o a un oggetto servizio.

Sintassi

BOOL CloseServiceHandle(
  [in] SC_HANDLE hSCObject
);

Parametri

[in] hSCObject

Handle per l'oggetto gestione controllo del servizio o l'oggetto servizio da chiudere. Gli handle per gli oggetti di gestione controllo del servizio vengono restituiti dalla funzione OpenSCManager e gli handle per gli oggetti di servizio vengono restituiti dalla funzione OpenService o CreateService.

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.

Il codice di errore seguente può essere impostato dal gestore del controllo del servizio. Altri codici di errore possono essere impostati dalle funzioni del Registro di sistema chiamate dal gestore del controllo del servizio.

Codice restituito	Descrizione
ERROR_INVALID_HANDLE	L'handle specificato non è valido.

Commenti

La funzione CloseServiceHandle non elimina l'oggetto gestione controlli del servizio a cui fa riferimento l'handle. Impossibile eliminare un oggetto di gestione controllo del servizio. Un oggetto servizio può essere eliminato chiamando la funzione DeleteService .

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