IByteBuffer::CopyTo-Methode

Artikel
06/13/2023

[Die CopyTo-Methode ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Es ist nicht für die Verwendung in Windows Server 2003 mit Service Pack 1 (SP1) und höher, Windows Vista, Windows Server 2008 und nachfolgenden Versionen des Betriebssystems verfügbar. Die IStream-Schnittstelle bietet ähnliche Funktionen.]

Die CopyTo-Methode kopiert eine angegebene Anzahl von Bytes vom aktuellen Suchzeiger im -Objekt auf den aktuellen Suchzeiger in einem anderen Objekt.

Syntax

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

Parameter

pByteBuffer [in]: Zeigt auf den Zieldatenstrom. Der Stream, auf den pByteBuffer verweist, kann ein neuer Stream oder ein Klon des Quelldatenstroms sein.
cb [in]: Anzahl der Bytes, die aus dem Quellstream kopiert werden sollen.
pcbRead [out]: Zeiger auf den Speicherort, an dem diese Methode die tatsächliche Anzahl von Bytes schreibt, die aus der Quelle gelesen werden. Sie können diesen Zeiger auf NULL festlegen, um anzugeben, dass Sie an diesem Wert nicht interessiert sind. In diesem Fall stellt diese Methode nicht die tatsächliche Anzahl der gelesenen Bytes bereit.
pcbWritten [out]: Zeiger auf den Speicherort, an dem diese Methode die tatsächliche Anzahl von Bytes schreibt, die in das Ziel geschrieben wurden. Sie können diesen Zeiger auf NULL festlegen, um anzugeben, dass Sie an diesem Wert nicht interessiert sind. In diesem Fall stellt diese Methode nicht die tatsächliche Anzahl der geschriebenen Bytes bereit.

Rückgabewert

Der Rückgabewert ist ein HRESULT. Der Wert S_OK gibt an, dass der Aufruf erfolgreich war.

Bemerkungen

Diese Methode kopiert die angegebenen Bytes von einem Stream in einen anderen. Es kann auch verwendet werden, um einen Stream in sich selbst zu kopieren. Der Suchzeiger in jedem Stream instance wird an die Anzahl der gelesenen oder geschriebenen Bytes angepasst.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Ende des Supports (Client)	Windows XP
Ende des Supports (Server)	Windows Server 2003
Header	Scardssp.h
Typbibliothek	Scardssp.tlb
DLL	Scardssp.dll
IID	IID_IByteBuffer ist definiert als E126F8FE-A7AF-11D0-B88A-00C04FD424B9

Freigeben über