CAsyncMonikerFile::OnProgress
バインド操作の現在の進行状況を示すために、通常、時間のかかる操作中に適切な間隔でモニカーによって繰り返し呼び出されます。
virtual void OnProgress(
ULONG ulProgress,
ULONG ulProgressMax,
ULONG ulStatusCode,
LPCTSTR szStatusText
);
パラメーター
ulProgress
バインド操作の現在の進行状況を ulProgressMax によって指定された最大の相対値で示します。ulProgressMax
この操作の OnProgress 呼び出しの期間における、ulProgress の予定最大値を示します。ulStatusCode
バインド操作の進行状況に関連する追加情報を指定します。 BINDSTATUS 列挙型の値の、いずれかが有効な値として使用されます。 有効値については、「解説」を参照してください。szStatusText
ulStatusCode の値に依存した、現在の進行状況に関する情報。 有効値については、「解説」を参照してください。
解説
ulStatusCode に使用される値と、対応する szStatusText の値は、次のとおりです。
BINDSTATUS_FINDINGRESOURCE
バインド操作は、オブジェクトを持っているリソースまたはバインドされるストレージを検索中です。 szStatusText には、検索されるリソースの表示名 (たとえば "www.microsoft.com") を指定します。BINDSTATUS_CONNECTING
バインド操作は、バインドされるオブジェクトまたはストレージがあるリソースに接続中です。 szStatusText には、接続されるリソースの表示名 (たとえば IP アドレス) を指定します。BINDSTATUS_SENDINGREQUEST
バインド操作は、バインドされるオブジェクトまたはストレージを要求中です。 szStatusText には、オブジェクトの表示名 (たとえばファイル名) を指定します。BINDSTATUS_REDIRECTING
バインド操作は、別のデータの場所にリダイレクトされました。 szStatusText には、新しいデータの場所の表示名を指定します。BINDSTATUS_USINGCACHEDCOPY
バインド操作は、要求されたオブジェクトまたはストレージをキャッシュされたコピーから取得中です。 szStatusText は NULL です。BINDSTATUS_BEGINDOWNLOADDATA
バインド操作は、バインドされるオブジェクトまたはストレージの受信を開始しました。 szStatusText には、データの場所の表示名を指定します。BINDSTATUS_DOWNLOADINGDATA
バインド操作は、バインドされるオブジェクトまたはストレージの受信を継続しています。 szStatusText には、データの場所の表示名を指定します。BINDSTATUS_ENDDOWNLOADDATA
バインド操作は、バインドされるオブジェクトまたはストレージの受信を終了しました。 szStatusText には、データの場所の表示名を指定します。BINDSTATUS_CLASSIDAVAILABLE
バインドされるオブジェクトのインスタンスを作成中です。 szStatusText には、新しいオブジェクトの CLSID を文字列形式で指定し、クライアントはバインド操作を必要に応じてキャンセルできます。
必要条件
**ヘッダー:**afxole.h