Freigeben über


CAsyncMonikerFile::OnProgress

Wiederholt aufgerufen über den Moniker, um den aktuellen Status dieses Bindevorgangs, in der Regel in angemessenen Intervallen während eines längeren Vorgangs anzugeben.

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

Parameter

  • ulProgress
    Gibt den aktuellen Status des Bindevorgangs relativ zum erwarteten maximalen an, das in ulProgressMax angegeben wird.

  • ulProgressMax
    Gibt den erwarteten maximalen Wert von ulProgress während der Dauer der Aufrufe OnProgress für diesen Vorgang an.

  • ulStatusCode
    Stellt zusätzliche Informationen über den Status des Bindevorgangs bereit. Gültige Werte werden von der BINDSTATUS-Enumeration entnommen. Mögliche Werte finden Sie in den Hinweisen.

  • szStatusText
    Informationen zum aktuellen Status, je nach Wert von ulStatusCode. Mögliche Werte finden Sie in den Hinweisen.

Hinweise

Mögliche Werte für ulStatusCode (und szStatusText für jeden Wert sind):

  • BINDSTATUS_FINDINGRESOURCE
    Der Bindevorgang durchsucht die Ressource, der das Objekt oder den Speicher Bindung zu enthält. szStatusText gibt den Anzeigenamen der Ressource an, die für gefunden wird (beispielsweise, "www.microsoft.com ").

  • BINDSTATUS_CONNECTING
    Der Bindevorgang verbindet die Ressource an, der das Objekt oder den Speicher Bindung zu enthält. szStatusText gibt den Anzeigenamen der Ressource an, die mit verbunden ist (beispielsweise, eine IP-Adresse).

  • BINDSTATUS_SENDINGREQUEST
    Der Bindevorgang fordert das Objekt oder den Speicher, an die gebunden ist. szStatusText gibt den Anzeigenamen des Objekts an (beispielsweise, ein Dateiname).

  • BINDSTATUS_REDIRECTING
    Der Bindevorgang hat sich an einem Speicherort der unterschiedlichen Daten umgeleitet. szStatusText gibt den Anzeigenamen des neuen Datenspeicherorts an.

  • BINDSTATUS_USINGCACHEDCOPY
    Der Bindevorgang ruft das angeforderte Objekt oder den Speicher von eine zwischengespeicherte Kopie ab. szStatusText ist NULL.

  • BINDSTATUS_BEGINDOWNLOADDATA
    Der Bindevorgang wurde gestartet, das Objekt oder den Speicher Empfangen von, die gebunden ist. szStatusText gibt den Anzeigenamen des Datenspeicherorts an.

  • BINDSTATUS_DOWNLOADINGDATA
    Der Bindevorgang wird fortgesetzt, um das Objekt oder den Speicher zu empfangen, die gebunden ist. szStatusText gibt den Anzeigenamen des Datenspeicherorts an.

  • BINDSTATUS_ENDDOWNLOADDATA
    Der Bindevorgang wurde beendet, das Objekt oder den Speicher zu empfangen, die gebunden ist. szStatusText gibt den Anzeigenamen des Datenspeicherorts an.

  • BINDSTATUS_CLASSIDAVAILABLE
    Eine Instanz des Objekts, das gebunden ist, ist nur ungefähr erstellt. szStatusText stellt die CLSID des neuen Objekts im Zeichenfolgenformat und ermöglicht dem Client eine Möglichkeit erhält, den Bindevorgang abzubrechen, wenn dies erforderlich ist.

Anforderungen

Header: afxole.h

Siehe auch

Referenz

CAsyncMonikerFile-Klasse

Hierarchiediagramm