SHCreateStreamOnFileA-Funktion (shlwapi.h)

[SHCreateStreamOnFile- steht für die Verwendung in den im Abschnitt "Anforderungen" angegebenen Betriebssystemen zur Verfügung. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein. Verwenden Sie stattdessen SHCreateStreamOnFileEx.]

Öffnet oder erstellt eine Datei und ruft einen Datenstrom zum Lesen oder Schreiben in diese Datei ab.

Syntax

LWSTDAPI SHCreateStreamOnFileA(
  [in]  LPCSTR  pszFile,
  [in]  DWORD   grfMode,
  [out] IStream **ppstm
);

Parameter

[in] pszFile

Typ: LPCTSTR-

Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den Dateinamen angibt.

[in] grfMode

Typ: DWORD-

Mindestens ein STGM- Werte, die zum Angeben des Dateizugriffsmodus und zum Erstellen und Löschen des Datenstroms verwendet werden.

[out] ppstm

Typ: IStream-**

Empfängt einen IStream- Schnittstellenzeiger für den datenstrom, der der Datei zugeordnet ist.

Rückgabewert

Typ: HRESULT-

Wenn diese Funktion erfolgreich ist, wird S_OKzurückgegeben. Andernfalls wird ein HRESULT- Fehlercode zurückgegeben.

Bemerkungen

SHCreateStreamOnFileEx alle STGM- Modi vollständig unterstützt und dem Aufrufer das Angeben von Dateiattributen ermöglicht, wenn eine neue Datei erstellt wird.

Anforderungen