Fonction SHCreateStreamOnFileA (shlwapi.h)

Article
03/04/2024

[SHCreateStreamOnFile est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera 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 à 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 de fichier.

[in] grfMode

Type : DWORD

Une ou plusieurs valeurs STGM 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 retournée

Type : HRESULT

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

Remarques

SHCreateStreamOnFileEx prend entièrement en charge tous les modes STGM et permet à l’appelant de spécifier des attributs de fichier lors de la création d’un fichier.

Notes

L’en-tête shlwapi.h définit SHCreateStreamOnFile en tant qu’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. La combinaison 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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlwapi.h
Bibliothèque	Shlwapi.lib
DLL	Shlwapi.dll (version 5.0 ou ultérieure)

Partager via