DeregisterService

9/8/2008

Essa função pára uma instância serviço.

Syntax

BOOL DeregisterService(
  HANDLE hDevice
);

Parameters

• hDevice
  [no] Identificador de instância de serviço retornada por ActivateService, RegisterService, ou GetServiceHandle.

Return Value

Um diferente de zero valor indica sucesso. Um valor de zero indica falha. Para informações de erro estendidas get, chamar GetLastError.

Remarks

DeregisterService vai chamar primeiro para o serviço é exportado xxx_IOControl (services.exe) Com o dwCode valor Definido como IOCTL_SERVICE_QUERY_CAN_DEINIT. Se xxx_IOControl Retorna um valor de TRUE e define a reserva passada para um diferente de zero valor, DeregisterService não descarregará o serviço. Se o serviço for ser descarregado, todos os serviço super soquetes associado com o serviço instância será desacoplado e será o Services.exe chamar xxx_Deinit (services.exe).

Se a instância serviço for o último serviço carregado por um serviço DLL, o DLL serão descarregadas da memória depois de chamar a xxx_Deinit Retorna. É extremamente importante que há outros segmentos criados pelo DLL são execução depois que o DLL tiver sido descarregadas da memória porque descarregar o DLL descarregará quaisquer páginas codificar. Qualquer segmento que tenta acessar essas páginas codificar irão causar uma exceção.

Security Note:

DeregisterService pode ser chamado a partir de aplicativos ou com privilégios normais, regardless of a configuração do sinalizador Registro DEVFLAGS_TRUSTEDCALLERONLY para o serviço.Se um aplicativo privilegiado tiver carregado um serviço, um aplicativo normal não pode descarregar o serviço.No entanto, se um aplicativo normal foi carregado de serviço, em seguida, em um aplicativo privilegiado ou um aplicativo normal pode descarregar o serviço.

Requirements

Header	service.h
Library	coredll.lib
Windows Embedded CE	Windows CE .NET 4.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

ActivateService
RegisterService
GetServiceHandle
xxx_Deinit (Services.exe)
xxx_IOControl (Services.exe)

Concepts

Services.exe Registry Settings

Other Resources

Services.exe