IOpcFactory::CreateStreamOnFile-Methode (msopc.h)

Artikel
11/20/2024

Erstellt einen Datenstrom über eine Datei. Diese Methode ist ein vereinfachter Wrapper für einen Aufruf der CreateFile--Funktion. CreateFile Parameter, die nicht über diese Methode verfügbar gemacht werden, verwenden ihre Standardwerte. Weitere Informationen finden Sie unter CreateFile-.

Syntax

HRESULT CreateStreamOnFile(
  [in]          LPCWSTR               filename,
  [in]          OPC_STREAM_IO_MODE    ioMode,
  [in]          LPSECURITY_ATTRIBUTES securityAttributes,
  [in]          DWORD                 dwFlagsAndAttributes,
  [out, retval] IStream               **stream
);

Parameter

[in] filename

Der Name der Datei, über die der Datenstrom erstellt wird.

[in] ioMode

Der Wert, der den Lese-/Schreibstatus des zu erstellenden Datenstroms beschreibt.

[in] securityAttributes

Informationen zur SECURITY_ATTRIBUTES Struktur in diesem Parameter finden Sie in der funktion CreateFile.

[in] dwFlagsAndAttributes

Die Einstellungen und Attribute der Datei. Für die meisten Dateien können FILE_ATTRIBUTE_NORMAL verwendet werden.

Weitere Informationen zu diesem Parameter finden Sie unter CreateFile.

[out, retval] stream

Ein Zeiger auf die IStream- Schnittstelle des Datenstroms.

Rückgabewert

Die Methode gibt ein HRESULT-zurück. Mögliche Werte sind die Werte in der folgenden Tabelle, sind jedoch nicht beschränkt.

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.
E_INVALIDARG	Der im ioMode Parameter übergebene Wert ist kein gültiger OPC_STREAM_IO_MODE Enumerationswert.
E_POINTER	Mindestens einer der Dateinamen und Stream- Parameter ist NULL-.
	Ein HRESULT- Fehlercode aus der CreateFile--Funktion.

Bemerkungen

Verwenden Sie keinen Datenstrom, um Paketdaten zu serialisieren, wenn derselbe Datenstrom zum Deserialisieren eines Pakets verwendet wird, da der Versuch zu einem nicht definierten Verhalten führen kann.

Informationen zur Verwendung dieser Methode beim Laden oder Speichern eines Pakets finden Sie unter Laden eines Pakets oder Speichern eines Pakets Programmieraufgabe.

Unterstützung für frühere Windows-Versionen

Das Verhalten und die Leistung dieser Methode sind in allen unterstützten Windows-Versionen identisch. Weitere Informationen finden Sie unter Erste Schritte mit der Verpackungs-APIund Platform Update für Windows Vista.

Threadsicherheit

Das Verpacken von Objekten ist nicht threadsicher.

Weitere Informationen finden Sie im Erste Schritte mit der Verpackungs-API.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	msopc.h