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

Voir aussi

ISequentialStream ::Read