enumDependentServicesW 函数 (winsvc.h)

项目
08/27/2023

检索依赖于指定服务的每个服务的名称和状态;也就是说，指定的服务必须运行，依赖服务才能运行。

语法

BOOL EnumDependentServicesW(
  [in]            SC_HANDLE              hService,
  [in]            DWORD                  dwServiceState,
  [out, optional] LPENUM_SERVICE_STATUSW lpServices,
  [in]            DWORD                  cbBufSize,
  [out]           LPDWORD                pcbBytesNeeded,
  [out]           LPDWORD                lpServicesReturned
);

参数

[in] hService

服务的句柄。此句柄由 OpenService 或 CreateService 函数返回，并且必须具有 SERVICE_ENUMERATE_DEPENDENTS 访问权限。有关详细信息，请参阅服务安全和访问权限。

[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 结构的数组的指针，这些结构接收数据库中每个依赖服务的名称和服务状态信息。缓冲区必须足够大，以便保存结构及其成员指向的字符串。

此数组中服务的顺序与服务的开始顺序相反。换句话说，数组中的第一个服务是最后启动的服务，数组中的最后一个服务是首先启动的服务。

此数组的最大大小为 64,000 字节。若要确定所需的大小，请为此参数指定 NULL ，为 cbBufSize 参数指定 0。函数将失败， GetLastError 将返回 ERROR_MORE_DATA。 该“bbytesNeeded”参数将接收所需大小。

[in] cbBufSize

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

[out] pcbBytesNeeded

指向变量的指针，该变量接收存储服务条目数组所需的字节数。仅当 lpServices 指向的缓冲区太小（由函数失败和 ERROR_MORE_DATA 错误指示）时，变量才会接收此值;否则， 未定义“bbytesNeeded” 的内容。

[out] lpServicesReturned

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

返回值

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

如果函数失败，则返回值为零。要获得更多的错误信息，请调用 GetLastError。

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

返回代码	说明
ERROR_ACCESS_DENIED	句柄没有 SERVICE_ENUMERATE_DEPENDENTS 访问权限。
ERROR_INVALID_HANDLE	指定的句柄无效。
ERROR_INVALID_PARAMETER	指定的参数无效。
ERROR_MORE_DATA	lpServices 指向的缓冲区不够大。函数将 lpServicesReturned 指向的变量设置为存储在缓冲区中的服务条目的实际数目。函数将由字节数Needed 指向的变量设置为存储所有服务条目所需的字节数。

注解

返回的服务条目按开始顺序的相反顺序排序，并考虑组顺序。如果需要停止依赖服务，可以使用写入 lpServices 缓冲区的条目顺序以正确的顺序停止依赖服务。

示例

有关示例，请参阅停止服务。

注意

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

要求

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