Skip to content

catlservicemodulet-handler-function.md

Latest commit

 

History

History
47 lines (44 loc) · 1.67 KB

catlservicemodulet-handler-function.md

File metadata and controls

47 lines (44 loc) · 1.67 KB
title CAtlServiceModuleT::Handler Function | Microsoft Docs
ms.custom
ms.date 11/04/2016
ms.reviewer
ms.suite
ms.technology
cpp-windows
ms.tgt_pltfrm
ms.topic article
f1_keywords
CServiceModule::Handler
CServiceModule.Handler
Handler
dev_langs
C++
helpviewer_keywords
Handler method
ms.assetid 14db5f2a-be87-4774-a296-445cb6fc7b2e
caps.latest.revision 10
author mikeblome
ms.author mblome
manager ghogen
translation.priority.ht
cs-cz
de-de
es-es
fr-fr
it-it
ja-jp
ko-kr
pl-pl
pt-br
ru-ru
tr-tr
zh-cn
zh-tw

CAtlServiceModuleT::Handler Function

CAtlServiceModuleT::Handler is the routine that the service control manager (SCM) calls to retrieve the status of the service and give it various instructions (such as stopping or pausing). The SCM passes an operation code to Handler to indicate what the service should do. A default ATL-generated service only handles the stop instruction. If the SCM passes the stop instruction, the service tells the SCM that the program is about to stop. The service then calls PostThreadMessage to post a quit message to itself. This terminates the message loop and the service will ultimately close.

To handle more instructions, you need to change the m_status data member initialized in the CAtlServiceModuleT constructor. This data member tells the SCM which buttons to enable when the service is selected in the Services Control Panel application.

See Also

Services
CAtlServiceModuleT::Handler