Método IByteBuffer::SetSize
[O método SetSize 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 SetSize altera o tamanho do objeto de fluxo.
Sintaxe
HRESULT SetSize(
[in] LONG libNewSize
);
Parâmetros
-
libNewSize [in]
-
Novo tamanho do fluxo como um número de bytes
Valor retornado
O valor retornado é um HRESULT. Um valor de S_OK indica que a chamada foi bem-sucedida.
Comentários
O método IByteBuffer::SetSize altera o tamanho do objeto de fluxo. Chame esse método para pré-alocar espaço para o fluxo. Se o parâmetro libNewSize for maior que o tamanho do fluxo atual, o fluxo será estendido para o tamanho indicado preenchendo o espaço intermediário com bytes de valor indefinido. Essa operação será semelhante ao método IByteBuffer::Write se o ponteiro seek estiver além do final do fluxo atual.
Se o parâmetro libNewSize for menor que o fluxo atual, o fluxo será truncado para o tamanho indicado.
O ponteiro seek não é afetado pela alteração no tamanho do fluxo.
Chamar IByteBuffer::SetSize pode ser uma maneira eficaz de tentar obter uma grande parte do espaço contíguo.
Exemplos
O exemplo a seguir mostra a definição do tamanho do buffer.
LONG lNewSize = 256;
HRESULT hr;
// Change the buffer size.
hr = pIByteBuff->SetSize(lNewSize);
if (FAILED(hr))
printf("Failed IByteBuffer::SetSize\n");
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 |