EnumServicesStatusA 函数（winsvc.h）

项目
11/20/2024

枚举指定服务控制管理器数据库中的服务。提供了每个服务的名称和状态。

此函数已被 EnumServicesStatusEx 函数取代。它返回相同的信息 EnumServicesStatus 返回，以及服务的进程标识符和其他信息。此外，EnumServicesStatusEx 可用于枚举属于指定组的服务。

语法

BOOL EnumServicesStatusA(
  [in]                SC_HANDLE              hSCManager,
  [in]                DWORD                  dwServiceType,
  [in]                DWORD                  dwServiceState,
  [out, optional]     LPENUM_SERVICE_STATUSA lpServices,
  [in]                DWORD                  cbBufSize,
  [out]               LPDWORD                pcbBytesNeeded,
  [out]               LPDWORD                lpServicesReturned,
  [in, out, optional] LPDWORD                lpResumeHandle
);

参数

[in] hSCManager

服务控制管理器数据库的句柄。此句柄由 OpenSCManager 函数返回，并且必须具有SC_MANAGER_ENUMERATE_SERVICE访问权限。有关详细信息，请参阅服务安全和访问权限。

[in] dwServiceType

要枚举的服务的类型。此参数可以是以下一个或多个值。

价值	意义
SERVICE_DRIVER 0x0000000B	SERVICE_KERNEL_DRIVER和SERVICE_FILE_SYSTEM_DRIVER类型的服务。
SERVICE_FILE_SYSTEM_DRIVER 0x00000002	文件系统驱动程序服务。
SERVICE_KERNEL_DRIVER 0x00000001	驱动程序服务。
SERVICE_WIN32 0x00000030	SERVICE_WIN32_OWN_PROCESS和SERVICE_WIN32_SHARE_PROCESS类型的服务。
SERVICE_WIN32_OWN_PROCESS 0x00000010	在其自己的进程中运行的服务。
SERVICE_WIN32_SHARE_PROCESS 0x00000020	与一个或多个其他服务共享进程的服务。有关详细信息，请参阅服务程序。

[in] dwServiceState

要枚举的服务的状态。此参数可以是下列值之一。

价值	意义
SERVICE_ACTIVE 0x00000001	枚举处于以下状态的服务：SERVICE_START_PENDING、SERVICE_STOP_PENDING、SERVICE_RUNNING、SERVICE_CONTINUE_PENDING、SERVICE_PAUSE_PENDING和SERVICE_PAUSED。
SERVICE_INACTIVE 0x00000002	枚举处于SERVICE_STOPPED状态的服务。
SERVICE_STATE_ALL 0x00000003	合并以下状态：SERVICE_ACTIVE和SERVICE_INACTIVE。

[out, optional] lpServices

指向缓冲区的指针，该缓冲区包含一组 ENUM_SERVICE_STATUS 结构，这些结构接收数据库中每个服务的名称和服务状态信息。缓冲区必须足够大，才能容纳结构，以及其成员指向的字符串。

此数组的最大大小为 256K 字节。若要确定所需的大小，请为此参数指定 NULL，并为 cbBufSize 参数指定 0。该函数将失败，GetLastError 将返回ERROR_INSUFFICIENT_BUFFER。参数将接收所需的大小。

Windows Server 2003 和 Windows XP：此数组的最大大小为 64K 字节。从 SP1 和 SP2 的 Windows XP 增加到 Windows Server 2003 时，此限制已增加。

[in] cbBufSize

lpServices 参数指向的缓冲区的大小（以字节为单位）。

[out] pcbBytesNeeded

指向一个变量的指针，如果缓冲区太小，则接收返回剩余服务条目所需的字节数。

[out] lpServicesReturned

指向接收返回的服务条目数的变量的指针。

[in, out, optional] lpResumeHandle

指向一个变量的指针，该变量在输入中指定枚举的起点。首次调用此函数时，必须将此值设置为零。在输出中，如果函数成功，则此值为零。但是，如果函数返回零，并且 GetLastError 函数返回ERROR_MORE_DATA，则此值用于指示调用函数以检索其他数据时要读取的下一个服务条目。

返回值

如果函数成功，则返回值为非零。

如果函数失败，则返回值为零。若要获取扩展的错误信息，请调用 GetLastError。

服务控制管理器可以设置以下错误代码。其他错误代码可由服务控制管理器调用的注册表函数设置。

返回代码	描述
ERROR_ACCESS_DENIED	句柄没有SC_MANAGER_ENUMERATE_SERVICE访问权限。
ERROR_INVALID_HANDLE	指定的句柄无效。
ERROR_INVALID_PARAMETER	指定的参数无效。
ERROR_MORE_DATA	与 lpServices 缓冲区相比，服务条目要多。 lpServicesReturned 参数中返回写入 lpServices 的实际服务条目数。获取剩余条目所需的字节数在参数中返回。可以通过对 EnumServicesStatus 的附加调用枚举其余服务，lpResumeHandle 参数指示要读取的下一个服务。

言论

注意

winsvc.h 标头将 EnumServicesStatus 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。

要求

要求	价值
最低支持的客户端	Windows XP [仅限桌面应用]
支持的最低服务器	Windows Server 2003 [仅限桌面应用]
目标平台	窗户
标头	winsvc.h （包括 Windows.h）
库	Advapi32.lib
DLL	Advapi32.dll