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)