SHCreateStreamOnFileA-Funktion (shlwapi.h)

Artikel
11/20/2024

[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.

Anmerkung

Der Header "shlwapi.h" definiert SHCreateStreamOnFile als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	shlwapi.h
Library	Shlwapi.lib
DLL-	Shlwapi.dll (Version 5.0 oder höher)

Freigeben über