changeServiceConfig2A 函数 (winsvc.h)

项目
03/13/2024

更改服务的可选配置参数。

语法

BOOL ChangeServiceConfig2A(
  [in]           SC_HANDLE hService,
  [in]           DWORD     dwInfoLevel,
  [in, optional] LPVOID    lpInfo
);

参数

[in] hService

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

如果服务控制器处理 SC_ACTION_RESTART 操作， 则 hService 必须具有 SERVICE_START 访问权限。

[in] dwInfoLevel

要更改的配置信息。此参数的取值可为下列值之一：

值	含义
SERVICE_CONFIG_DELAYED_AUTO_START_INFO 3	lpInfo 参数是指向SERVICE_DELAYED_AUTO_START_INFO结构的指针。 Windows Server 2003 和 Windows XP：不支持此值。
SERVICE_CONFIG_DESCRIPTION 1	lpInfo 参数是指向 SERVICE_DESCRIPTION 结构的指针。
SERVICE_CONFIG_FAILURE_ACTIONS 2	lpInfo 参数是指向 SERVICE_FAILURE_ACTIONS 结构的指针。如果服务控制器处理 SC_ACTION_REBOOT 操作，则调用方必须具有 SE_SHUTDOWN_NAME 特权。有关详细信息，请参阅使用特殊特权运行。
SERVICE_CONFIG_FAILURE_ACTIONS_FLAG 4	lpInfo 参数是指向 SERVICE_FAILURE_ACTIONS_FLAG 结构的指针。 Windows Server 2003 和 Windows XP：不支持此值。
SERVICE_CONFIG_PREFERRED_NODE 9	lpInfo 参数是指向SERVICE_PREFERRED_NODE_INFO结构的指针。 Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP：不支持此值。
SERVICE_CONFIG_PRESHUTDOWN_INFO 7	lpInfo 参数是指向SERVICE_PRESHUTDOWN_INFO结构的指针。 Windows Server 2003 和 Windows XP：不支持此值。
SERVICE_CONFIG_REQUIRED_PRIVILEGES_INFO 6	lpInfo 参数是指向SERVICE_REQUIRED_PRIVILEGES_INFO结构的指针。 Windows Server 2003 和 Windows XP：不支持此值。
SERVICE_CONFIG_SERVICE_SID_INFO 5	lpInfo 参数是指向SERVICE_SID_INFO结构的指针。
SERVICE_CONFIG_TRIGGER_INFO 8	lpInfo 参数是指向 SERVICE_TRIGGER_INFO 结构的指针。 ChangeServiceConfig2 的 ANSI 版本不支持此值。 Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP：在 Windows Server 2008 R2 之前不支持此值。
SERVICE_CONFIG_LAUNCH_PROTECTED 12	lpInfo 参数是SERVICE_LAUNCH_PROTECTED_INFO结构的指针。注意从 Windows 8.1 开始支持此值。

[in, optional] lpInfo

指向要为配置信息设置的新值的指针。此数据的格式取决于 dwInfoLevel 参数的值。如果此值为 NULL，则信息保持不变。

返回值

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

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

注解

ChangeServiceConfig2 函数更改服务控制管理器数据库中指定服务的可选配置信息。可以使用 QueryServiceConfig2 函数获取当前可选配置信息。

不能为共享服务控制管理器进程的服务设置 SERVICE_CONFIG_FAILURE_ACTIONS 值。这包括可执行映像为“Services.exe”的所有服务。

可以分别使用 ChangeServiceConfig 和 QueryServiceConfig 函数更改和查询其他配置信息。

如果将服务配置为在完成并出现错误后重启，则服务控制管理器会将重启操作排队，使其在指定的时间延迟后发生。无法取消排队重启操作。如果服务已手动重启，然后在排队重启操作发生之前停止，则服务将在时间延迟过后意外重启。必须显式禁用服务，以防止它重启。

SERVICE_CONFIG_LAUNCH_PROTECTED值可用于启动受保护的服务。若要启动受保护的服务，必须使用特殊证书对服务进行签名。

SERVICE_CONFIG_LAUNCH_PROTECTED示例：

SERVICE_LAUNCH_PROTECTED_INFO Info;
SC_HANDLE hService;

Info.dwLaunchProtected = SERVICE_LAUNCH_PROTECTED_ANTIMALWARE_LIGHT;

hService = CreateService (...);

if (ChangeServiceConfig2(hService, 
                        SERVICE_CONFIG_LAUNCH_PROTECTED,
                        &Info) == FALSE)
{
    Result = GetLastError();
}

示例

有关示例，请参阅更改服务的配置。

注意

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

要求

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