Partager via


Fonction SHCreateStreamOnFileEx (shlwapi.h)

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

Syntaxe

LWSTDAPI SHCreateStreamOnFileEx(
  [in]           LPCWSTR pszFile,
  [in]           DWORD   grfMode,
  [in]           DWORD   dwAttributes,
  [in]           BOOL    fCreate,
  [in, optional] IStream *pstmTemplate,
  [out]          IStream **ppstm
);

Paramètres

[in] pszFile

Type : LPCWSTR

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

[in] dwAttributes

Type : DWORD

Une ou plusieurs valeurs d’indicateur qui spécifient des attributs de fichier dans le cas où un nouveau fichier est créé. Pour obtenir la liste complète des valeurs possibles, consultez le paramètre dwFlagsAndAttributes de la fonction CreateFile .

[in] fCreate

Type : BOOL

Valeur BOOL qui permet de spécifier, conjointement avec grfMode, comment les fichiers existants doivent être traités lors de la création du flux. Pour plus de détails, consultez la section Notes.

[in, optional] pstmTemplate

Type : IStream*

Réservé.

[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

La fonction SHCreateStreamOnFileEx étend la sémantique des indicateurs STGM et produit le même effet que l’appel de la fonction CreateFile .

Les paramètres grfMode et fCreate fonctionnent ensemble pour spécifier le comportement de la fonction par rapport aux fichiers existants.

grfMode fCréer Un fichier existe ? Comportement
STGM_CREATE Ignoré Yes Le fichier est recréé.
STGM_CREATE Ignoré No Le fichier est créé.
STGM_FAILIFTHERE FALSE Yes Le fichier est ouvert.
STGM_FAILIFTHERE FALSE No L’appel échoue.
STGM_FAILIFTHERE TRUE Yes L’appel échoue.
STGM_FAILIFTHERE TRUE No Le fichier est créé.

Configuration requise

   
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 6.0 ou ultérieure)