IPortableDevicePropertiesBulkCallback::OnProgress メソッド (portabledeviceapi.h)
OnProgress メソッドは、IPortableDevicePropertiesBulk::Start によって開始された一括操作がデバイスにデータを送信し、何らかの情報を受信したときに SDK によって呼び出されます。
構文
HRESULT OnProgress(
[in] REFGUID pContext,
[in] IPortableDeviceValuesCollection *pResults
);
パラメーター
[in] pContext
進行中の操作を識別する GUID へのポインター。 この値は Queue... によって生成されます。 IPortableDevicePropertiesBulk インターフェイスの メソッド。
[in] pResults
デバイスから取得した結果を含む IPortableDeviceValuesCollection インターフェイスへのポインター。 このインターフェイスには、1 つ以上の IPortableDeviceValues インターフェイスが 保持されます。 これらの各インターフェイスには、 これらの 値が関係するオブジェクトのオブジェクト ID を指定する文字列値 (VT_LPSTR) を持つ 1 つのWPD_OBJECT_ID プロパティが保持されます。 各 IPortableDeviceValues インターフェイスの残りの値は、報告される一括操作によって異なります。 QueueGetValuesByObjectFormat メソッドと QueueGetValuesByObjectList メソッドの場合、さまざまな型の値が取得されます。 QueueSetValuesByObjectList の場合、値の設定時に発生したエラーに対して HRESULT 値がVT_ERRORされます。
戻り値
アプリケーションは、S_OK、または操作を破棄するエラー コードを返す必要があります。 すべてのエラー コードは、同じ方法で処理されます。
注釈
このメソッドは、操作の大きさに応じて、1 回または複数回呼び出すことができます。
このメソッドは、必ずしも一度にすべてのプロパティを取得するとは限らず、特定の順序でプロパティを返すわけではありません。
このメソッドが複数回呼び出されると、毎回同じオブジェクト識別子のプロパティが返されることがあります。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | portabledeviceapi.h |
| Library | PortableDeviceGUIDs.lib |