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 |
| 헤더 |
|
| IDL |
|
| DLL |
|
| CLSID |
CLSID_SWbemSink |
| IID |
IID_ISWbemSinkEvents |