SHCreateStreamOnFileA, fonction (shlwapi.h)

Article
11/20/2024

[SHCreateStreamOnFile est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions ultérieures. Utilisez plutôt SHCreateStreamOnFileEx.]

Ouvre ou crée un fichier et récupère un flux pour lire ou écrire dans ce fichier.

Syntaxe

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

Paramètres

[in] pszFile

Type : LPCTSTR

Pointeur vers une chaîne terminée par null qui spécifie le nom du fichier.

[in] grfMode

Type : DWORD

Une ou plusieurs STGM valeurs utilisées pour spécifier le mode d’accès aux fichiers et la façon dont l’objet qui expose le flux est créé et supprimé.

[out] ppstm

Type : IStream**

Reçoit un pointeur d’interface IStream pour le flux associé au fichier.

Valeur de retour

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un HRESULT code d’erreur.

Remarques

SHCreateStreamOnFileEx prend entièrement en charge tous les modes STGM et permet à l’appelant de spécifier des attributs de fichier si vous créez un fichier.

Note

L’en-tête shlwapi.h définit SHCreateStreamOnFile comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	shlwapi.h
bibliothèque	Shlwapi.lib
DLL	Shlwapi.dll (version 5.0 ou ultérieure)

Partager via