共用方式為


CAsyncMonikerFile::OnProgress

重複呼叫這個 Moniker 繫結作業目前進度,通常在合理的時間間隔 (以長時間作業時。

virtual void OnProgress(
   ULONG ulProgress,
   ULONG ulProgressMax,
   ULONG ulStatusCode,
   LPCTSTR szStatusText 
);

參數

  • ulProgress
    表示繫結作業的目前進度相對於在 ulProgressMax指出預期的最大值。

  • ulProgressMax
    表示 ulProgress 預期的最大值呼叫期間保持為這個作業的 OnProgress

  • 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 的字串格式的,為用戶端提供機會取消繫結作業。

需求

Header: afxole.h

請參閱

參考

CAsyncMonikerFile 類別

階層架構圖