Fonction SHCreateStreamOnFileW (shlwapi.h)
[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 pour lire ou écrire dans ce fichier.
Syntaxe
LWSTDAPI SHCreateStreamOnFileW(
[in] LPCWSTR 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 comme un 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.
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) |