共用方式為


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

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

傳回碼 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

另請參閱

LockServiceDatabase

OpenSCManager

QUERY_SERVICE_LOCK_STATUS

服務組態

服務函式

UnlockServiceDatabase