Função CloseServiceHandle (winsvc.h)

Artigo
08/27/2023

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
ERROR_INVALID_HANDLE	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