queryServiceLockStatusA 函式 (winsvc.h)

發行項
03/13/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。

服務控制管理員可以設定下列錯誤碼。服務控制管理員呼叫的登錄函式可以設定其他錯誤碼。

傳回碼	Description
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 [僅限桌面應用程式]
目標平台	Windows
標頭	winsvc.h (包含 Windows.h)
程式庫	Advapi32.lib
Dll	Advapi32.dll