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.

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

Confira também

CreateService

DeleteService

OpenSCManager

Openservice

Identificadores do SCM

Funções de serviço