IPortableDevicePropertiesBulkCallback::OnProgress 메서드(portabledeviceapi.h)
OnProgress 메서드는 IPortableDevicePropertiesBulk::Start에서 시작된 대량 작업이 디바이스에 데이터를 보내고 일부 정보를 다시 수신했을 때 SDK에서 호출됩니다.
구문
HRESULT OnProgress(
[in] REFGUID pContext,
[in] IPortableDeviceValuesCollection *pResults
);
매개 변수
[in] pContext
진행 중인 작업을 식별하는 GUID에 대한 포인터입니다. 이 값은 큐에서 생성됩니다... IPortableDevicePropertiesBulk 인터페이스의 메서드입니다.
[in] pResults
디바이스에서 검색된 결과를 포함하는 IPortableDeviceValuesCollection 인터페이스에 대한 포인터입니다. 이 인터페이스에는 하나 이상의 IPortableDeviceValues 인터페이스가 있습니다. 이러한 각 인터페이스에는 이러한 값과 관련된 개체의 개체 ID를 지정하는 문자열 값(VT_LPSTR)이 있는 하나의 WPD_OBJECT_ID 속성이 포함됩니다. 각 IPortableDeviceValues 인터페이스의 나머지 값은 보고되는 대량 작업에 따라 달라집니다. QueueGetValuesByObjectFormat 및 QueueGetValuesByObjectList 메서드의 경우 다양한 형식의 값이 검색됩니다. QueueSetValuesByObjectList의 경우 값을 설정할 때 발생하는 모든 오류에 대해 HRESULT 값이 VT_ERROR.
반환 값
애플리케이션은 작업을 중단하기 위해 S_OK 또는 오류 코드를 반환해야 합니다. 모든 오류 코드는 동일한 방식으로 처리됩니다.
설명
이 메서드는 작업의 규모에 따라 한 번 또는 여러 번 호출할 수 있습니다.
이 메서드는 모든 속성을 한 번에 검색할 필요는 없으며 특정 순서로 속성을 반환하지도 않습니다.
이 메서드가 여러 번 호출되면 매번 동일한 개체 식별자에 대한 속성을 반환할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | portabledeviceapi.h |
| 라이브러리 | PortableDeviceGUIDs.lib |