QueryServiceLockStatusA 函数 (winsvc.h)
[此函数在 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。
服务控制管理器可以设置以下错误代码。 其他错误代码可由服务控制管理器调用的注册表函数设置。
返回代码 | 说明 |
---|---|
|
句柄没有SC_MANAGER_QUERY_LOCK_STATUS访问权限。 |
|
锁状态信息比 lpLockStatus 缓冲区中容纳的锁状态信息还多。 获取所有信息所需的字节数在 “线路板”Needed 参数中返回。 不会向 lpLockStatus 写入任何内容。 |
|
指定的句柄无效。 |
注解
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 |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈