IByteBuffer :: CopyTo, méthode
[La méthode CopyTo peut être utilisée dans les systèmes d’exploitation spécifiés dans la section relative à la configuration requise. elle 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 offre des fonctionnalités similaires.]
La méthode CopyTo copie un nombre spécifié d’octets à partir 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 [ dans]
-
Pointe vers le flux de destination. Le flux vers lequel pointe pByteBuffer peut être un nouveau flux ou un clone du flux source.
-
CB [ dans]
-
Nombre d’octets à copier à partir du flux source.
-
pcbRead [ à]
-
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 vous n’êtes pas intéressé par cette valeur. Dans ce cas, cette méthode ne fournit pas le nombre réel d’octets lus.
-
pcbWritten [ à]
-
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 vous n’êtes pas intéressé par cette valeur. Dans ce cas, cette méthode ne fournit pas le nombre réel d’octets écrits.
Valeur de retour
La valeur de retour est un 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. Elle peut également être utilisée pour copier un flux vers lui-même. Le pointeur de recherche dans chaque instance de flux est ajusté pour le nombre d’octets lus ou écrits.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows [Applications de bureau XP uniquement] |
| Serveur minimal pris en charge |
Windows Serveur 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 |
|
| Bibliothèque de types |
|
| DLL |
|
| IID |
IID _ IByteBuffer est défini en tant que E126F8FE-A7AF-11D0-B88A-00C04FD424B9 |