Méthode IByteBuffer::CopyTo

Article
08/14/2024

[La méthode CopyTo est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il n’est pas disponible pour une utilisation dans Windows Server 2003 avec Service Pack 1 (SP1) et versions ultérieures, Windows Vista, Windows Server 2008 et les versions ultérieures du système d’exploitation. L’interface IStream fournit des fonctionnalités similaires.]

La méthode CopyTo copie un nombre spécifié d’octets du pointeur de recherche actuel dans l’objet vers le pointeur de recherche actuel dans un autre objet.

Syntaxe

HRESULT CopyTo(
  [in]  LPBYTEBUFFER *pByteBuffer,
  [in]  LONG         cb,
  [out] LONG         *pcbRead,
  [out] LONG         *pcbWritten
);

Paramètres

pByteBuffer [in]: Pointe vers le flux de destination. Le flux pointé vers pByteBuffer peut être un nouveau flux ou un clone du flux source.
cb [in]: Nombre d’octets à copier à partir du flux source.
pcbRead [out]: Pointeur vers l’emplacement où cette méthode écrit le nombre réel d’octets lus à partir de la source. Vous pouvez définir ce pointeur sur NULL pour indiquer que cette valeur ne vous intéresse pas. Dans ce cas, cette méthode ne fournit pas le nombre réel d’octets lus.
pcbWritten [out]: Pointeur vers l’emplacement où cette méthode écrit le nombre réel d’octets écrits dans la destination. Vous pouvez définir ce pointeur sur NULL pour indiquer que cette valeur ne vous intéresse pas. Dans ce cas, cette méthode ne fournit pas le nombre réel d’octets écrits.

Valeur retournée

La valeur de retour est HRESULT. La valeur S_OK indique que l’appel a réussi.

Notes

Cette méthode copie les octets spécifiés d’un flux vers un autre. Il peut également être utilisé pour copier un flux sur lui-même. Le pointeur de recherche dans chaque flux instance est ajusté pour le nombre d’octets lus ou écrits.

Spécifications

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]
Fin de la prise en charge des clients	Windows XP
Fin de la prise en charge des serveurs	Windows Server 2003
En-tête	Scardssp.h
Bibliothèque de types	Scardssp.tlb
DLL	Scardssp.dll
IID	IID_IByteBuffer est défini comme E126F8FE-A7AF-11D0-B88A-00C04FD424B9

Partager via