queryServiceLockStatusW 函数 (winsvc.h)

项目
08/27/2023

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

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

语法

BOOL QueryServiceLockStatusW(
  [in]            SC_HANDLE                    hSCManager,
  [out, optional] LPQUERY_SERVICE_LOCK_STATUSW 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 缓冲区中容纳的信息要多。获取所有信息所需的字节数在 bytesNeeded 参数中返回。不会向 lpLockStatus 写入任何内容。
ERROR_INVALID_HANDLE	指定的句柄无效。

注解

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

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

注意

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

要求


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