QueryServiceStatus 函式 (winsvc.h)

擷取指定服務的目前狀態。

此函式已被 QueryServiceStatusEx 函式取代。 QueryServiceStatusEx 會 傳回相同的 查詢ServiceStatus 資訊，並新增進程識別碼和服務的其他資訊。

語法

BOOL QueryServiceStatus(
  [in]  SC_HANDLE        hService,
  [out] LPSERVICE_STATUS lpServiceStatus
);

[in] hService

服務的控制碼。此控制碼是由 OpenService 或 CreateService 函式傳回，而且必須具有SERVICE_QUERY_STATUS存取權限。如需詳細資訊，請參閱服務安全性和存取權限。

[out] lpServiceStatus

接收狀態資訊的 SERVICE_STATUS 結構的指標。

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

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

傳回碼	描述
ERROR_ACCESS_DENIED	控制碼沒有SERVICE_QUERY_STATUS存取權限。
ERROR_INVALID_HANDLE	控制代碼無效。

QueryServiceStatus函式會傳回向服務控制管理員報告的最新服務狀態資訊。如果服務剛變更其狀態，可能尚未更新服務控制管理員。