IFsiFileItem2::RemoveStream-Methode (imapi2fs.h)

Artikel
08/24/2023

Entfernt eine benannte Streamzuordnung mit einer Datei.

Syntax

HRESULT RemoveStream(
  [in] BSTR name
);

Parameter

[in] name

Zeichenfolge, die den Namen der zu entfernenden benannten Streamzuordnung angibt. Dies sollte den Pfad nicht enthalten und sollte nur gültige Zeichen gemäß den Dateisystembenennungskonventionen enthalten.

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

Diese Methode kann nur für Dateielemente aufgerufen werden, die im Dateisystemimage vorhanden sind.

Der Benutzer muss UDF aktivieren und die UDF-Revision auf 2.00 oder höher festlegen, um benannte Streams zu unterstützen.

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


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

IFsiFileItem2::AddStream

Freigeben über