CAsyncMonikerFile::OnProgress
更新 : 2007 年 11 月
バインド操作の現在の進行状況を示すために、通常、時間のかかる操作中に適切な間隔でモニカによって繰り返し呼び出されます。
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