IStreamConcatenate::Initialize-Methode (imapi2.h)

Artikel
02/26/2024

Initialisiert diesen Stream aus zwei Eingabestreams.

Syntax

HRESULT Initialize(
  [in] IStream *stream1,
  [in] IStream *stream2
);

Parameter

[in] stream1

Eine IStream-Schnittstelle des ersten Streams, der diesem Stream hinzugefügt werden soll.

[in] stream2

Eine IStream-Schnittstelle des zweiten Streams, der diesem Stream 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
E_OUTOFMEMORY	Fehler beim Zuordnen des erforderlichen Arbeitsspeichers. Wert: 0x8007000E
E_INVALIDARG	Mindestens ein Argument ist ungültig. 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::Initialize2

Freigeben über