IStorage::CreateStream-Methode (objidl.h)

Artikel
03/04/2024

Die CreateStream-Methode erstellt und öffnet ein Streamobjekt mit dem angegebenen Namen, der in diesem Speicherobjekt enthalten ist. Alle Elemente innerhalb eines Speicherobjekts, sowohl Streams als auch andere Speicherobjekte, werden im gleichen Namensraum aufbewahrt.

Syntax

HRESULT CreateStream(
  [in]  const OLECHAR *pwcsName,
  [in]  DWORD         grfMode,
  [in]  DWORD         reserved1,
  [in]  DWORD         reserved2,
  [out] IStream       **ppstm
);

Parameter

[in] pwcsName

Ein Zeiger auf eine Unicode-Zeichenfolge mit breitem Zeichen null, die den Namen des neu erstellten Datenstroms enthält. Der Name kann später verwendet werden, um den Stream zu öffnen oder erneut zu öffnen. Der Name darf nicht länger als 31 Zeichen sein, wobei der Zeichenfolgenabschluss nicht enthalten ist. Die Zeichen 000 bis 01f, welche als erste Zeichen des Namens des Datenstroms/Speichers dienen, sind durch die OLE für die Benutzung reserviert. Dies ist eine Verbunddateieinschränkung, keine strukturierte Speichereinschränkung.

[in] grfMode

Gibt den Zugriffsmodus an, der beim Öffnen des neu erstellten Datenstroms verwendet werden soll. Weitere Informationen und Beschreibungen der möglichen Werte finden Sie unter STGM-Konstanten.

[in] reserved1

Für die zukünftige Verwendung reserviert. Muss 0 (null) sein.

[in] reserved2

Für die zukünftige Verwendung reserviert. Muss 0 (null) sein.

[out] ppstm

Zeigen Sie bei der Rückgabe auf die Position des neuen IStream-Schnittstellenzeigers. Dies ist nur gültig, wenn der Vorgang erfolgreich ist. Wenn ein Fehler auftritt, wird dieser Parameter auf NULL festgelegt.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	Beschreibung
S_OK	Der neue Stream wurde erfolgreich erstellt.
E_PENDING	Nur asynchroner Speicher: Ein Teil oder alle erforderlichen Daten sind derzeit nicht verfügbar.
STG_E_ACCESSDENIED	Nicht genügend Berechtigungen zum Erstellen von Stream.
STG_E_FILEALREADYEXISTS	Der für den Stream angegebene Name ist bereits im Speicherobjekt vorhanden, und der grfMode-Parameter enthält den Wert STGM_FAILIFTHERE.
STG_E_INSUFFICIENTMEMORY	Der Stream wurde aufgrund eines Mangels an Arbeitsspeicher nicht erstellt.
STG_E_INVALIDFLAG	Der für den grfMode-Parameter angegebene Wert ist kein gültiger STGM-Konstantenwert .
STG_E_INVALIDFUNCTION	Die angegebene Kombination von Flags im grfMode-Parameter wird nicht unterstützt. Beispielsweise, wenn diese Methode ohne das flag STGM_SHARE_EXCLUSIVE aufgerufen wird.
STG_E_INVALIDNAME	Ungültiger Wert für pwcsName.
STG_E_INVALIDPOINTER	Der für das Streamobjekt angegebene Zeiger war ungültig.
STG_E_INVALIDPARAMETER	Einer der Parameter war ungültig.
STG_E_REVERTED	Das Speicherobjekt wurde durch einen rückgängig machen Vorgang darüber in der Transaktionsstruktur ungültig gemacht.
STG_E_TOOMANYOPENFILES	Der Stream wurde nicht erstellt, da zu viele geöffnete Dateien vorhanden sind.

Hinweise

Wenn ein Stream mit dem im pwcsName-Parameter angegebenen Namen bereits vorhanden ist und der grfMode-Parameter das flag STGM_CREATE enthält, wird der vorhandene Stream durch einen neu erstellten Stream ersetzt. Sowohl die Zerstörung des alten Datenstroms als auch die Erstellung des neuen Streamobjekts unterliegen dem Transaktionsmodus für das übergeordnete Speicherobjekt.

Die von COM bereitgestellte Implementierung einer zusammengesetzten Datei der IStorage::CreateStream-Methode unterstützt die folgenden Verhaltensweisen nicht:

Das STGM_DELETEONRELEASE-Flag wird nicht unterstützt.
Der Transacted-Modus (STGM_TRANSACTED) wird für Streamobjekte nicht unterstützt.
Das mehrmalse Öffnen desselben Datenstroms aus demselben Speicher wird nicht unterstützt. Das STGM_SHARE_EXCLUSIVE Freigabemodusflagge muss im grfMode-Parameter angegeben werden.

Wenn der Stream bereits vorhanden ist und grfMode auf STGM_FAILIFTHERE festgelegt ist, schlägt diese Methode mit dem Rückgabewert STG_E_FILEALREADYEXISTS fehl.

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

IStorage – Implementierung zusammengesetzter Dateien

IStorage::OpenStream

IStream

Freigeben über