다음을 통해 공유


IBackgroundCopyJob::GetState 메서드(bits.h)

작업의 상태를 검색합니다.

구문

HRESULT GetState(
  [out] BG_JOB_STATE *pVal
);

매개 변수

[out] pVal

작업의 상태입니다. 예를 들어 상태는 작업이 오류인지, 데이터를 전송하는지 또는 일시 중단되었는지를 반영합니다. 작업 상태 목록은 BG_JOB_STATE 열거형을 참조하세요.

반환 값

이 메서드는 다음 HRESULT 값과 다른 값을 반환합니다.

반환 코드 설명
S_OK
작업의 상태가 성공적으로 검색되었습니다.
E_INVALIDARG
pJobState 매개 변수는 NULL일 수 없습니다.

설명

작업이 오류가 발생하거나 작업의 모든 파일을 전송한 시기를 알고 싶다면 이 메서드를 사용하여 작업 상태를 폴링하거나 이벤트가 발생할 때 알림을 받도록 등록할 수 있습니다. 이벤트 알림을 수신하도록 등록하는 자세한 내용은 IBackgroundCopyCallback 인터페이스를 참조하세요.

예제

IBackgroundCopyManager::GetJob 메서드에 대한 예제 코드를 참조하세요.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows XP
지원되는 최소 서버 Windows Server 2003
대상 플랫폼 Windows
헤더 bits.h
라이브러리 Bits.lib
DLL QmgrPrxy.dll

추가 정보

BG_JOB_STATE, 작업의 상태 확인, IBackgroundCopyCallback