DFileSystemImageEvents::Update-Methode (imapi2fs.h)

Artikel
08/24/2023

Implementieren Sie diese Methode, um Statusbenachrichtigungen über den aktuellen Schreibvorgang zu erhalten. Die Benachrichtigungen werden beim Kopieren des Inhalts einer Datei oder beim Hinzufügen von Verzeichnissen oder Dateien zum Dateisystemimage gesendet.

Syntax

HRESULT Update(
  [in]  IDispatch *object,
  [in]  BSTR      currentFile,
  [in]  LONG      copiedSectors,
  [out] LONG      totalSectors
);

Parameter

[in] object

Eine IFileSystemImage-Schnittstelle des Dateisystemimages, das geschrieben wird.

Dieser Parameter ist ein CFileSystemImage-Objekt in einem Skript.

[in] currentFile

Zeichenfolge, die den vollständigen Pfad der zu schreibenden Datei enthält.

[in] copiedSectors

Anzahl der kopierten Sektoren.

[out] totalSectors

Gesamtanzahl der Sektoren in der Datei.

Rückgabewert

Rückgabewerte werden ignoriert.

Hinweise

Benachrichtigungen werden als Reaktion auf das Aufrufen einer der folgenden Methoden gesendet:

Benachrichtigungen können auch gesendet werden, wenn eine der folgenden Methoden zum Importieren eines UDF-Dateisystems aufgerufen wird, das mithilfe der sofortigen Zuordnung erstellt wurde (direkte Zuordnung bedeutet, dass die Dateidaten im Dateideskriptor enthalten sind, anstatt Zuordnungsdeskriptoren im Dateideskriptor zu haben, die auf Datensektoren verweisen):

Benachrichtigung wird gesendet:

Einmal vor dem Hinzufügen des ersten Sektors einer Datei (copiedSectors ist 0)
Für jedes geschriebene Megabyte
Nach dem endgültigen Schreibvorgang, wenn die Datei nicht auf einer Megabyte-Grenze endet

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista, Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	imapi2fs.h

Weitere Informationen

DFileSystemImageEvents

Freigeben über