|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| No
| Win32s
| No
| Import Library
| advapi32.lib
| Header File
| winsvc.h
| Unicode
| No
| Platform Notes
| None
|
|
|
QueryServiceStatus
The QueryServiceStatus function retrieves the current status of the specified service.
BOOL QueryServiceStatus(
SC_HANDLE hService,
| // handle of service
| LPSERVICE_STATUS lpServiceStatus
| // address of service status structure
| );
|
|
Parameters
hService
Identifies the service. This handle is returned by the OpenService or the CreateService function, and it must have SERVICE_QUERY_STATUS access.
lpServiceStatus
Points to a SERVICE_STATUS structure in which the status information is returned.
Return Values
If the function succeeds, the return value is nonzero.
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_ACCESS_DENIED
| The specified handle was not opened with SERVICE_QUERY_STATUS access.
| ERROR_INVALID_HANDLE
| The specified handle is invalid.
|
Remarks
The QueryServiceStatus function returns the most recent service status information reported to the
service control manager. The service may have just changed its status and may
not have updated the service control manager yet. Applications can find out the
absolutely latest service status by interrogating the service directly by using
the ControlService function with the SERVICE_CONTROL_INTERROGATE control code.
See Also
ControlService, CreateService, OpenService, SERVICE_STATUS, SetServiceStatus
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
