IFsiDirectoryItem::Add-Methode (imapi2fs.h)

Artikel
08/24/2023

Fügt dem Dateisystemimage eine Datei oder ein Verzeichnis hinzu, die vom IFsiItem-Objekt beschrieben wird.

Syntax

HRESULT Add(
  [in] IFsiItem *item
);

Parameter

[in] item

Eine IFsiItem-Schnittstelle des IFsiFileItem - oder IFsiDirectoryItem-Objekts , das dem Dateisystemimage hinzugefügt 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
E_POINTER	Der Zeiger ist ungültig. Wert: 0x80004003
IMAPI_E_INVALID_PATH	Pfad '%1!s!' ist falsch formatiert oder enthält ungültige Zeichen. Wert: 0xC0AAB110
IMAPI_E_DATA_STREAM_READ_FAILURE	Daten aus dem Datenstrom, der für die Datei '%1!ls!' bereitgestellt wird, können nicht gelesen werden. Wert: 0xC0AAB129
IMAPI_E_DUP_NAME	ls!' Name ist bereits vorhanden. Wert: 0xC0AAB112
IMAPI_E_NO_UNIQUE_NAME	Versuch, '%1!ls!' hinzuzufügen failed: Kann keinen dateisystemspezifischen eindeutigen Namen für %2!ls! erstellen. -Dateisystem durchgeführt. Wert: 0xC0AAB113
IMAPI_E_IMAGE_SIZE_LIMIT	Hinzufügen von '%1!ls!' würde zu einem Ergebnisbild führen, das größer als der aktuell konfigurierte Grenzwert ist. Wert: 0xC0AAB120
IMAPI_E_ISO9660_LEVELS	ISO9660 ist auf 8 Verzeichnisebenen beschränkt. Wert: 0xC0AAB131
IMAPI_E_TOO_MANY_DIRS	Dieses Dateisystemimage enthält zu viele Verzeichnisse für %1!ls! -Dateisystem durchgeführt. Wert: 0xC0AAB130
IMAPI_E_DIR_NOT_FOUND	Das Verzeichnis '%1!s!' in der FileSystemImage-Hierarchie nicht gefunden. Wert: 0xC0AAB11A
IMAPI_E_NOT_IN_FILE_SYSTEM	Diese Datei oder das Verzeichnis 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
IMAPI_E_IMAGE_SIZE_LIMIT	Das Hinzufügen dieser Datei oder des Verzeichnisses würde dazu führen, dass ein Ergebnisimage größer als der aktuell konfigurierte Grenzwert ist. Wert: 0xC0AAB120
E_OUTOFMEMORY	Fehler beim Zuordnen des erforderlichen Arbeitsspeichers. Wert: 0x8007000E

Hinweis Werte, die von der IUnknown::QueryInterface-Methode zurückgegeben werden, können hier ebenfalls zurückgegeben werden.

Hinweise

Um ein Verzeichniselement oder Dateielement zu erstellen, rufen Sie die IFileSystemImage::CreateDirectoryItem-Methode bzw. die IFileSystemImage::CreateFileItem-Methode auf.

Sobald dem Dateisystemimage ein Element hinzugefügt wurde, wird die IFsiFileItem::get_Data-Eigenschaft schreibgeschützt.

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::AddDirectory

IFsiDirectoryItem::AddFile

IFsiDirectoryItem::Remove

IFsiFileItem

Freigeben über