QueryServiceStatus 함수(winsvc.h)

지정된 서비스의 현재 상태 검색합니다.

이 함수는 QueryServiceStatusEx 함수로 대체되었습니다. QueryServiceStatusEx 는 프로세스 식별자와 서비스에 대한 추가 정보를 추가하여 QueryServiceStatus 가 반환하는 것과 동일한 정보를 반환합니다.

구문

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

[in] hService

서비스에 대한 핸들입니다. 이 핸들은 OpenService 또는 CreateService 함수에서 반환되며 SERVICE_QUERY_STATUS 액세스 권한이 있어야 합니다. 자세한 내용은 서비스 보안 및 액세스 권한을 참조하세요.

[out] lpServiceStatus

상태 정보를 수신하는 SERVICE_STATUS 구조체에 대한 포인터입니다.

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

서비스 제어 관리자가 설정할 수 있는 오류 코드는 다음과 같습니다. 다른 오류 코드는 서비스 제어 관리자가 호출하는 레지스트리 함수에서 설정할 수 있습니다.

반환 코드	설명
ERROR_ACCESS_DENIED	핸들에 SERVICE_QUERY_STATUS 액세스 권한이 없습니다.
ERROR_INVALID_HANDLE	핸들이 잘못되었습니다.

QueryServiceStatus 함수는 서비스 제어 관리자에 보고된 최신 서비스 상태 정보를 반환합니다. 서비스에서 상태 변경한 경우 서비스 제어 관리자가 아직 업데이트되지 않았을 수 있습니다.