Passer au contenu principal
Cette méthode est implémentée côté client et sert à fournir, à partir d’une source personnalisée, les données à traiter. Votre implémentation de cette méthode doit créer un tableau de données et le transmettre à l’appelant, qui sera ensuite chargé d’en libérer la mémoire après utilisation.

​
Syntaxe

​
C++

HRESULT Read(
  SAFEARRAY(BYTE)* Data,
  int              Count,
  int*             BytesRead
);

​
C#

int Read(
  out byte[] Data,
  int        Count
);

​
Visual Basic .NET

Function Read( _
  ByRef Data() As Byte, _
  ByVal Count As Integer _
) As Integer

​
Paramètres

Data [out] Ce paramètre correspond aux données à lire. Votre implémentation de cette méthode doit créer ce tableau et y écrire les données requises. L’appelant est responsable de libérer cette mémoire lorsqu’elle n’est plus nécessaire. Count [in] Ce paramètre spécifie le nombre maximal d’octets à lire. BytesRead [out, retval] Ce paramètre spécifie le nombre d’octets effectivement lus (c’est-à-dire la taille de la mémoire occupée par le tampon Data). Si ce nombre est supérieur à 0, la méthode sera appelée de nouveau jusqu’à ce que ce paramètre renvoie 0.

​
Valeurs de retour

[C++ uniquement] Si cette méthode renvoie une valeur autre que S_OK, cela indique qu’une erreur s’est produite côté client.

​
Remarques

L’implémentation côté client de cette méthode doit garantir que toutes les exceptions levées à l’intérieur de la méthode sont interceptées et gérées, et qu’aucune exception n’est propagée en dehors de la méthode. La propagation d’une exception en dehors de la méthode peut entraîner des résultats imprévisibles (par exemple, l’arrêt du programme).

​
Voir aussi

IReadStream