Compartilhar via


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

Confira também

CreateService

DeleteService

OpenSCManager

Openservice

Identificadores do SCM

Funções de serviço