ISWbemSinkEvents::OnProgress 이벤트

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