Método IByteBuffer::CopyTo
[O método CopyTo está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele não está disponível para uso no Windows Server 2003 com Service Pack 1 (SP1) e posterior, Windows Vista, Windows Server 2008 e versões subsequentes do sistema operacional. A interface IStream fornece funcionalidade semelhante.]
O método CopyTo copia um número especificado de bytes do ponteiro de busca atual no objeto para o ponteiro de busca atual em outro objeto.
Sintaxe
HRESULT CopyTo(
[in] LPBYTEBUFFER *pByteBuffer,
[in] LONG cb,
[out] LONG *pcbRead,
[out] LONG *pcbWritten
);
Parâmetros
-
pByteBuffer [in]
-
Aponta para o fluxo de destino. O fluxo apontado por pByteBuffer pode ser um novo fluxo ou um clone do fluxo de origem.
-
cb [in]
-
Número de bytes a serem copiados do fluxo de origem.
-
pcbRead [out]
-
Ponteiro para o local em que esse método grava o número real de bytes lidos da origem. Você pode definir esse ponteiro como NULL para indicar que não está interessado nesse valor. Nesse caso, esse método não fornece o número real de bytes lidos.
-
pcbWritten [out]
-
Ponteiro para o local em que esse método grava o número real de bytes gravados no destino. Você pode definir esse ponteiro como NULL para indicar que não está interessado nesse valor. Nesse caso, esse método não fornece o número real de bytes gravados.
Valor retornado
O valor retornado é um HRESULT. Um valor de S_OK indica que a chamada foi bem-sucedida.
Comentários
Esse método copia os bytes especificados de um fluxo para outro. Ele também pode ser usado para copiar um fluxo para si mesmo. O ponteiro de busca em cada instância de fluxo é ajustado para o número de bytes lidos ou gravados.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2003 [somente aplicativos da área de trabalho] |
| Fim do suporte ao cliente |
Windows XP |
| Fim do suporte ao servidor |
Windows Server 2003 |
| Cabeçalho |
|
| Biblioteca de tipos |
|
| DLL |
|
| IID |
IID_IByteBuffer é definido como E126F8FE-A7AF-11D0-B88A-00C04FD424B9 |