IStream_Read, fonction (shlwapi.h)
Lit les octets d’un flux spécifié et retourne une valeur qui indique si tous les octets ont été correctement lus.
Syntaxe
LWSTDAPI IStream_Read(
[in] IStream *pstm,
[out] void *pv,
[in] ULONG cb
);
Paramètres
[in] pstm
Type : IStream*
Pointeur vers l’interface IStream du flux à partir duquel lire.
[out] pv
Type : VOID*
Pointeur vers une mémoire tampon pour recevoir les données de flux à partir de pstm. Cette mémoire tampon doit avoir une taille d’au moins cb octets.
[in] cb
Type : ULONG
Nombre d’octets de données que la fonction doit tenter de lire à partir du flux d’entrée.
Valeur retournée
Type : HRESULT
Retourne S_OK si la fonction lit correctement le nombre spécifié d’octets à partir du flux, ou un code d’échec COM dans le cas contraire. En particulier, si la tentative de lecture a réussi mais que moins d’octets cb ont été lus, la fonction retourne E_FAIL.
Remarques
Cette fonction appelle la méthode ISequentialStream ::Read pour lire les données du flux spécifié dans la mémoire tampon. Si la fonction échoue pour une raison quelconque, le contenu de la mémoire tampon de sortie et la position du pointeur de lecture dans le flux d’entrée ne sont pas définis.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel, Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server, Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | shlwapi.h |
| DLL | Shlwapi.dll (version 5.0 ou ultérieure) |