IFsiFileItem2::AddStream-Methode (imapi2fs.h)

Artikel
08/24/2023

Ordnet einen benannten Stream einer bestimmten Datei im Dateisystemimage zu.

Syntax

HRESULT AddStream(
  [in] BSTR    name,
  [in] IStream *streamData
);

Parameter

[in] name

Eine Zeichenfolge stellt den Namen des benannten Streams dar. Dies sollte den Pfad nicht enthalten und sollte nur gültige Zeichen gemäß den Dateisystembenennungskonventionen enthalten.

[in] streamData

Eine IStream-Schnittstelle des benannten Datenstroms, der zum Schreiben in das resultierende Dateisystemimage verwendet wird.

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/-wert	BESCHREIBUNG
IMAPI_S_IMAGE_FEATURE_NOT_SUPPORTED Wert: 0x00AAB15FL	Das Feature wird für die aktuelle Dateisystemrevision nicht unterstützt und wird daher ohne dieses Feature erstellt.
E_POINTER Wert: 0x80004003	Der Zeiger ist ungültig.
IMAPI_E_INVALID_PARAM Wert: 0xC0AAB101	Der für den Parameter '%1!ls!' angegebene Wert ungültig.
IMAPI_E_NOT_IN_FILE_SYSTEM Wert: 0xC0AAB10B	ls!' ist nicht Teil des Dateisystems. Sie muss hinzugefügt werden, um diesen Vorgang abzuschließen.
IMAPI_E_READONLY Wert: 0xC0AAB102	Das IFileSystemImage-Objekt , auf das verwiesen wird, befindet sich im schreibgeschützten Modus.
IMAPI_E_FSI_INTERNAL_ERROR Wert: 0xC0AAB100L	Interner Dateisystemfehler ist aufgetreten.
IMAPI_E_DUP_NAME Wert: 0xC0AAB112L	'%1!ls!' Name ist bereits vorhanden.
IMAPI_E_DATA_STREAM_READ_FAILURE Wert: 0xC0AAB129L	Daten aus dem Datenstrom, der für die Datei '%1!ls!' bereitgestellt wird, können nicht gelesen werden.
IMAPI_E_IMAGE_SIZE_LIMIT Wert: 0xC0AAB120L	Das Hinzufügen von '%1!ls!' würde dazu führen, dass ein Ergebnisbild größer als der aktuell konfigurierte Grenzwert ist.
IMAPI_E_DATA_STREAM_INCONSISTENCY Wert: 0xC0AAB128L	Der für die Datei '%1!ls!' bereitgestellte Datenstrom ist inkonsistent ; erwartet %2! I64d! Bytes, gefunden %3! I64d!
E_OUTOFMEMORY Wert: 0x8007000EL	Fehler beim Zuordnen des erforderlichen Arbeitsspeichers.

Hinweise

Die Datei, der der benannte Stream hinzugefügt wird, muss bereits im Dateisystemimage vorhanden sein. Wenn diese Methode mit einem Namen aufgerufen wird, der bereits für einen benannten Stream vorhanden ist, gibt sie einen Fehler zurück und ersetzt nicht den vorhandenen benannten Stream.

Wenn diese Methode für ein Dateisystemobjekt aufgerufen wird, das keine UDF in der Liste der Dateisysteme enthält, die für die Erstellung im resultierenden Image aktiviert sind, oder wenn die UDF-Revision unter 2.00 liegt, gibt diese Methode Erfolgscode IMAPI_S_IMAGE_FEATURE_NOT_SUPPORTED zurück. Dieser Erfolgscode gibt an, dass der benannte Stream hinzugefügt wurde, aber nicht im resultierenden Dateisystemimage angezeigt wird, es sei denn, die UDF-Revision 2.00 oder höher ist im Dateisystemobjekt aktiviert.

Derzeit wird IMAPI_E_READONLY zurückgegeben, wenn diese Methode für ein importiertes Dateisystemimage aufgerufen wird, unabhängig von der schreibgeschützten status des Images.

Diese Methode wird in Windows Server 2003 mit Service Pack 1 (SP1), Windows XP mit Service Pack 2 (SP2) und Windows Vista über das Windows Feature Pack for Storage unterstützt. Alle von diesem Updatepaket bereitgestellten Features werden in Windows 7 und Windows Server 2008 R2 nativ unterstü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

IFsiFileItem2

Freigeben über