Função CloseServiceHandle (winsvc.h)
Fecha um identificador para um gerenciador de controle de serviço ou objeto de serviço.
Sintaxe
BOOL CloseServiceHandle(
[in] SC_HANDLE hSCObject
);
Parâmetros
[in] hSCObject
Um identificador para o objeto do gerenciador de controle de serviço ou o objeto de serviço a ser fechado. Os identificadores para objetos do gerenciador de controle de serviço são retornados pela função OpenSCManager e os identificadores para objetos de serviço são retornados pela função OpenService ou CreateService .
Valor retornado
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
O código de erro a seguir pode ser definido pelo gerenciador de controle de serviço. Outros códigos de erro podem ser definidos por funções do Registro que são chamadas pelo gerenciador de controle de serviço.
| Código de retorno | Descrição |
|---|---|
|
O identificador especificado é inválido. |
Comentários
A função CloseServiceHandle não destrói o objeto do gerenciador de controle de serviço referenciado pelo identificador. Um objeto do gerenciador de controle de serviço não pode ser destruído. Um objeto de serviço pode ser destruído chamando a função DeleteService .
Exemplos
Para obter um exemplo, consulte Excluindo um serviço.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | winsvc.h (inclua Windows.h) |
| Biblioteca | Advapi32.lib |
| DLL | Advapi32.dll |