IStream::Clone-Methode (objidl.h)

Die Clone-Methode erstellt ein neues Streamobjekt mit einem eigenen Suchzeiger, der auf dieselben Bytes wie den ursprünglichen Stream verweist.

Syntax

HRESULT Clone(
  [out] IStream **ppstm
);

Parameter

[out] ppstm

Zeigen Sie bei erfolgreicher Ausführung auf den Speicherort eines IStream-Zeigers auf das neue Streamobjekt. Wenn ein Fehler auftritt, ist dieser Parameter NULL.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	Beschreibung
S_OK	Der Stream wurde erfolgreich geklont.
E_PENDING	Nur asynchroner Speicher: Ein Teil oder alle Daten des Datenstroms sind derzeit nicht verfügbar.
STG_E_INSUFFICIENTMEMORY	Der Stream wurde aufgrund eines Mangels an Arbeitsspeicher nicht geklont.
STG_E_INVALIDPOINTER	Der ppStm-Zeiger ist ungültig.
STG_E_REVERTED	Das Objekt wurde durch einen rückgängig machen Vorgang darüber in der Transaktionsstruktur ungültig gemacht.

Hinweise

Die Clone-Methode erstellt ein neues Streamobjekt für den Zugriff auf dieselben Bytes, jedoch mit einem separaten Suchzeiger. Das neue Streamobjekt sieht dieselben Daten wie das Quellstreamobjekt. Änderungen, die in ein Objekt geschrieben wurden, sind sofort im anderen sichtbar. Die Bereichssperre wird von den Streamobjekten gemeinsam genutzt.

Die anfängliche Einstellung des Suchzeigers im geklonten Stream instance entspricht der aktuellen Einstellung des Suchzeigers im ursprünglichen Stream zum Zeitpunkt des Klonvorgangs.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	objidl.h
Bibliothek	Uuid.lib
DLL	Ole32.dll

Weitere Informationen

IStream – Implementierung zusammengesetzter Dateien

IStream::CopyTo