QueryServiceLockStatusA 函数（winsvc.h）

项目
11/20/2024

[从 Windows Vista 起，此函数不起作用。]

检索指定服务控制管理器数据库的锁定状态。

语法

BOOL QueryServiceLockStatusA(
  [in]            SC_HANDLE                    hSCManager,
  [out, optional] LPQUERY_SERVICE_LOCK_STATUSA lpLockStatus,
  [in]            DWORD                        cbBufSize,
  [out]           LPDWORD                      pcbBytesNeeded
);

参数

[in] hSCManager

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

[out, optional] lpLockStatus

指向接收指定数据库的锁定状态的 QUERY_SERVICE_LOCK_STATUS 结构的指针，以及其成员指向的字符串。

[in] cbBufSize

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

[out] pcbBytesNeeded

指向一个变量的指针，该变量接收返回所有锁状态信息所需的字节数（如果函数失败）。

返回值

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

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

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

返回代码	描述
ERROR_ACCESS_DENIED	句柄没有SC_MANAGER_QUERY_LOCK_STATUS访问权限。
ERROR_INSUFFICIENT_BUFFER	锁状态信息多于适合 lpLockStatus 缓冲区。获取所有信息所需的字节数在参数中返回。任何内容都不会写入 lpLockStatus。
ERROR_INVALID_HANDLE	指定的句柄无效。

言论

QueryServiceLockStatus 函数返回一个 QUERY_SERVICE_LOCK_STATUS 结构，该结构指示指定的数据库是否已锁定。如果数据库已锁定，则结构提供拥有锁的用户的帐户名以及锁定的时长。

进程调用 LockServiceDatabase 函数来获取服务控制管理器数据库锁的所有权，并使用 UnlockServiceDatabase 函数释放锁。

注意

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

要求

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