Freigeben über


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