Funzione CloseServiceHandle (winsvc.h)
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 |
|---|---|
|
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 |