|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| No
| Win32s
| No
| Import Library
| advapi32.lib
| Header File
| winsvc.h
| Unicode
| WinNT
| Platform Notes
| None
|
|
|
RegisterServiceCtrlHandler
The RegisterServiceCtrlHandler function registers a function to handle service control requests for a
service.
SERVICE_STATUS_HANDLE RegisterServiceCtrlHandler(
LPCTSTR lpServiceName,
| // address of name of service
| LPHANDLER_FUNCTION lpHandlerProc
| // address of handler function
| );
|
|
Parameters
lpServiceName
Points to a null-terminated string that names the service run by the calling
thread. This is the service name that was specified in the CreateService function when the service was created.
lpHandlerProc
Points to the Handler function to be registered.
Return Values
If the function succeeds, the return value is a service status handle.
If the function fails, the return value is zero. To get extended error
information, call GetLastError.
Errors
The following error codes may be set by the service control manager. Other
error codes may be set by the registry functions that are called by the service
control manager.
Value
| Meaning
| ERROR_INVALID_NAME
| The specified service name is invalid.
| ERROR_SERVICE_DOES_NOT_EXIST
| The specified service does not exist.
|
Remarks
The ServiceMain function of a new service should immediately call the RegisterServiceCtrlHandler function to register a control handling function with the control dispatcher.
This enables the control dispatcher to invoke the specified function when it
receives control requests for this service. The threads of the calling process
can use the service status handle returned by this function to identify the
service in subsequent calls to the SetServiceStatus function.
This function must be called before the first SetServiceStatus call because it returns a service status handle for the caller to use so that
no other service can inadvertently set this service's status, which is
maintained by the service control manager. It also needs to be called before the first SetServiceStatus so that a control handler is in place to field control requests by the time
the service specifies the controls it accepts through the SetServiceStatus function.
When the control handler function is invoked with a control request, it must
call SetServiceStatus to notify the service control manager of its latest status, regardless of
whether the status of the service has changed.
The service status handle does not have to be closed.
See Also
CreateService, Handler, ServiceMain, SetServiceStatus
| Last news from Greatis Software |
 |
|
Nostalgia .Net |
|
.Net is powerful, but not all-powerful, so sometimes we need to use Win32 API for our .Net applications. It's simple enough with Platform Invoke if you have Win32 skill, but we do not always have time to dig the ancient documentation, declare the special types that are compatible with Win32, find the values of the Win32's constants and so on. Nostalgia .Net offers several simple-to-use classes, and components that will allow you to forget about the headache of Win32 and just use the power of Win32 in your application the same way as you use the native. Net classes. More » |
| Recommended software for developers |
 |
|
Ultimate Pack |
|
Component pack for Delphi and C++ Builder that contains runtime form designer, runtime object inspector, print suite and much more for the very special price. More » |
 |
|
Form Designer .Net |
|
Unique runtime form design solution that allows to edit any form in .Net WinForms application at runtime with full source codes for only 300 euro! More » |
 |
|
Print Suite .Net |
|
Print Suite .Net is a set of components for easy printing texts, images and grids from your WinForms applications. Full C# source codes are available More » |
 |
|
Gradient Controls .Net |
|
Gradient Controls .Net offers controls with gradient background feature. Labels, panels and so on... Full C# source codes are available More » |
 |
|
Greatis iGrid |
|
iGrid plots drawing grid right over your desktop, so you can use it everywhere, with any drawing application without any special plugins for different graphic editors. More » |
All the contacts and projectsDmitry Vasiliev (just.dmitry)
Related LinksSoftware for Visual Studio .NET developers
Software for Delphi and C++ Builder developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET More Online Helps Win32 Programmer's Reference
Win32 Multimedia Programmer's Reference
OLE Programmer's Reference
Microsoft Windows Pen API Programmer's Reference
Microsoft Windows Sockets 2 Reference
Microsoft Windows Telephony API (TAPI) Programmer's Reference
Unix Manual Pages
|
