Metodo IByteBuffer::CopyTo
[Il metodo CopyTo è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Non è disponibile per l'uso in Windows Server 2003 con Service Pack 1 (SP1) e versioni successive, Windows Vista, Windows Server 2008 e versioni successive del sistema operativo. L'interfaccia IStream offre funzionalità simili.
Il metodo CopyTo copia un numero specificato di byte dal puntatore di ricerca corrente nell'oggetto al puntatore di ricerca corrente in un altro oggetto .
Sintassi
HRESULT CopyTo(
[in] LPBYTEBUFFER *pByteBuffer,
[in] LONG cb,
[out] LONG *pcbRead,
[out] LONG *pcbWritten
);
Parametri
-
pByteBuffer [in]
-
Punta al flusso di destinazione. Il flusso a cui punta pByteBuffer può essere un nuovo flusso o un clone del flusso di origine.
-
cb [in]
-
Numero di byte da copiare dal flusso di origine.
-
pcbRead [out]
-
Puntatore alla posizione in cui questo metodo scrive il numero effettivo di byte letti dall'origine. È possibile impostare questo puntatore su NULL per indicare che non si è interessati a questo valore. In questo caso, questo metodo non fornisce il numero effettivo di byte letti.
-
pcbWritten [out]
-
Puntatore alla posizione in cui questo metodo scrive il numero effettivo di byte scritti nella destinazione. È possibile impostare questo puntatore su NULL per indicare che non si è interessati a questo valore. In questo caso, questo metodo non fornisce il numero effettivo di byte scritti.
Valore restituito
Il valore restituito è HRESULT. Un valore di S_OK indica che la chiamata ha avuto esito positivo.
Commenti
Questo metodo copia i byte specificati da un flusso a un altro. Può anche essere usato per copiare un flusso in se stesso. Il puntatore seek in ogni istanza del flusso viene modificato per il numero di byte letti o scritti.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato |
Windows XP [solo app desktop] |
Server minimo supportato |
Windows Server 2003 [solo app desktop] |
Fine del supporto client |
Windows XP |
Fine del supporto server |
Windows Server 2003 |
Intestazione |
|
Libreria dei tipi |
|
DLL |
|
IID |
IID_IByteBuffer è definito come E126F8FE-A7AF-11D0-B88A-00C04FD424B9 |