다음을 통해 공유


ISWbemSinkEvents::OnProgress 이벤트

비동기 호출이 진행 중인 호출의 상태를 반환하면 SWbemSinkOnProgress 이벤트가 트리거됩니다. 상태 업데이트를 지원하는 공급자에서 이벤트, 인스턴스 또는 클래스가 생성되는 경우 이 이벤트에 코드를 배치하여 사용자에게 비동기 작업의 상태에 대한 피드백을 제공할 수 있습니다. 상태 업데이트를 수신하려면 비동기 호출의 iFlags 매개 변수를 wbemFlagSendStatus(128/0x80)로 설정해야 합니다. 그렇지 않으면 이 이벤트가 트리거되지 않습니다.

이 구문에 대한 설명은 스크립팅 API의 문서 규칙을 참조하세요.

구문

SWbemSink.OnProgress( _
  ByVal iUpperBound, _
  ByVal iCurrent, _
  ByVal strMessage, _
  ByVal objWbemAsyncContext _
)

매개 변수

iUpperBound

완료할 총 작업 수를 설명하는 정수입니다.

iCurrent

처리 중인 현재 항목입니다.

strMessage

현재 작업의 상태를 설명하는 메시지입니다.

objWbemAsyncContext

원래 비동기 호출에 전달되는 SWbemNamedValueSet 개체입니다. 이 개체 싱크를 사용하여 여러 비동기 호출을 수행할 때 이 이벤트를 트리거하는 비동기 호출의 파생 위치를 식별하려면 이 매개 변수를 사용합니다.

반환 값

이 이벤트는 값을 반환하지 않습니다.

오류 코드

OnProgress 이벤트가 완료되면 Err 개체에 아래 오류 코드 중 하나가 포함될 수 있습니다.

wbemErrFailed - 2147749889 (0x80041001)

알 수 없는 오류입니다.

wbemErrOutOfMemory - 2147749894(0x80041006)

메모리가 부족하여 작업을 완료할 수 없습니다.

wbemErrTransportFailure - 2147749909(0x80041015)

네트워킹 오류가 발생하여 정상 작동을 방해합니다.

설명

비동기 호출이 진행 중인 호출의 상태를 반환하면 OnProgress 이벤트가 트리거됩니다. 상태 업데이트를 지원하는 공급자에서 이벤트, 인스턴스 또는 클래스가 생성되는 경우 이 이벤트에 코드를 배치하여 사용자에게 비동기 작업의 상태에 대한 피드백을 제공할 수 있습니다.

참고

비동기 콜백을 사용하면 인증되지 않은 사용자가 싱크에 데이터를 제공할 수 있습니다. 이렇게 하면 스크립트 및 애플리케이션에 보안 위험이 발생합니다. 위험을 제거하려면 반동기 또는 동기 통신을 사용합니다. 자세한 내용은 메서드 호출을 참조하세요.

요구 사항

요구 사항
지원되는 최소 클라이언트
Windows Vista
지원되는 최소 서버
Windows Server 2008
헤더
Wbemdisp.h
IDL
Wbemdisp.idl
DLL
Wbemdisp.dll
CLSID
CLSID_SWbemSink
IID
IID_ISWbemSinkEvents

추가 정보

SWbemSink