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 標頭會根據 UNICODE 預處理器常數的定義，將 QueryServiceLockStatus 定義為自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

要求

要求	價值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
支援的最低伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平臺	窗戶
標頭	winsvc.h （包括 Windows.h）
連結庫	Advapi32.lib
DLL	Advapi32.dll