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