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 |