IStreamConcatenate::Initialize2-Methode (imapi2.h)

Artikel
02/28/2024

Initialisiert diesen Stream aus einem Array von Eingabestreams.

Syntax

HRESULT Initialize2(
  [in] IStream **streams,
  [in] ULONG   streamCount
);

Parameter

[in] streams

Array von IStream-Schnittstellen der Streams, die diesem Stream hinzugefügt werden sollen.

[in] streamCount

Anzahl der Streams in Streams.

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
E_OUTOFMEMORY	Fehler beim Zuordnen des erforderlichen Arbeitsspeichers. Wert: 0x8007000E
E_INVALIDARG	Dieser Stream wurde bereits initialisiert. Wert: 0x80070057

Hinweise

Bei Verwendung der IStreamConcatenate-Schnittstelle führen die folgenden Szenarien zu nicht definierten Verhaltensweisen und sollten vermieden werden:

Jeder Teildatenstrom, der das MsftStreamConcatenate-Objekt komponiert, ist tatsächlich derselbe Stream.
Jeder der verketteten Streams wird außerhalb von IMAPI geändert (ausgelesen, in geschrieben oder gesucht).

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	imapi2.h

Weitere Informationen

IStreamConcatenate

IStreamConcatenate::Initialize

Freigeben über