QueryServiceStatus

最新推荐文章于 2024-01-12 16:27:49 发布

小发猫

最新推荐文章于 2024-01-12 16:27:49 发布

阅读量1.9k

点赞数

CC 4.0 BY-SA版权

文章标签： service function access windows server parameters

本文链接：https://blog.youkuaiyun.com/i_like_cpp/article/details/389525

博客介绍了QueryServiceStatus函数，该函数用于获取指定服务的当前状态，已被QueryServiceStatusEx函数取代。还说明了函数的参数、返回值，成功时返回非零值，失败返回零。此外，提到了备注、示例代码和要求等内容。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

QueryServiceStatus

The QueryServiceStatus function retrieves the current status of the specified service.

This function has been superseded by the QueryServiceStatusEx function. QueryServiceStatusEx returns the same information QueryServiceStatus returns, with the addition of the process identifier and additional information for the service.

BOOL QueryServiceStatus(
  SC_HANDLE hService,
  LPSERVICE_STATUS lpServiceStatus
);

Parameters

hService

[in] Handle to the service. This handle is returned by the OpenService or the CreateService function, and it must have the SERVICE_QUERY_STATUS access right. For more information, see Service Security and Access Rights.

lpServiceStatus

[out] Pointer to a SERVICE_STATUS structure that receives the status information.

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.

The following error codes can be set by the service control manager. Other error codes can be set by the registry functions that are called by the service control manager.

Return code	Description
ERROR_ACCESS_DENIED	The handle does not have the SERVICE_QUERY_STATUS access right.
ERROR_INVALID_HANDLE	The handle is invalid.

Remarks

The QueryServiceStatus function returns the most recent service status information reported to the service control manager. If the service just changed its status, it may not have updated the service control manager yet. Applications can find out the current service status by interrogating the service directly using the ControlService function with the SERVICE_CONTROL_INTERROGATE control code.

Example Code

For an example, see Starting a Service.

Requirements

Client	Requires Windows XP, Windows 2000 Professional, or Windows NT Workstation.
Server	Requires Windows Server 2003, Windows 2000 Server, or Windows NT Server.
Header	Declared in Winsvc.h; include Windows.h.
Library	Link to Advapi32.lib.
DLL	Requires Advapi32.dll.