IFsiDirectoryItem::AddFile-Methode (imapi2fs.h)

Artikel
03/01/2024

Fügt dem Dateisystemimage eine Datei hinzu.

Syntax

HRESULT AddFile(
  [in] BSTR    path,
  [in] IStream *fileData
);

Parameter

[in] path

Zeichenfolge, die den relativen Pfad des Verzeichnisses enthält, das die neue Datei enthalten soll.

Geben Sie den vollständigen Pfad an, wenn Sie diese Methode aus dem Stammverzeichniselement aufrufen.

[in] fileData

Eine IStream-Schnittstelle der Datei (Datenstrom), die in die Medien geschrieben werden soll.

Rückgabewert

S_OK wird bei Erfolg zurückgegeben, aber als Ergebnis der Implementierung können andere Erfolgscodes zurückgegeben werden. Die folgenden Fehlercodes werden häufig bei Einem Vorgangsfehler zurückgegeben, stellen jedoch nicht die einzigen möglichen Fehlerwerte dar:

Rückgabecode	Beschreibung
IMAPI_E_INVALID_PATH	Pfad '%1!s!' ist falsch formatiert oder enthält ungültige Zeichen. Wert: 0xC0AAB110
E_POINTER	Der Zeiger ist ungültig. Wert: 0x80004003
IMAPI_E_INVALID_PARAM	Der für den Parameter %1!ls! angegebene Wert ist ungültig. Wert: 0xC0AAB101
IMAPI_E_NOT_IN_FILE_SYSTEM	ls!' ist nicht Teil des Dateisystems. Sie muss hinzugefügt werden, um diesen Vorgang abzuschließen. Wert: 0xC0AAB10B
IMAPI_E_READONLY	Das FileSystemImage-Objekt befindet sich im schreibgeschützten Modus. Wert: 0xC0AAB102

Hinweise

Das Verzeichnis, das die neue Datei enthält, muss bereits innerhalb des Dateisystemimages vorhanden sein.

Anforderungen

Anforderung	Wert
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

IFsiDirectoryItem

IFsiDirectoryItem::Add

IFsiDirectoryItem::AddDirectory

IFsiDirectoryItem::Remove

Freigeben über