Compartilhar via


Método ILockBytes::SetSize (objidl.h)

O método SetSize altera o tamanho da matriz de bytes.

Sintaxe

HRESULT SetSize(
  [in] ULARGE_INTEGER cb
);

Parâmetros

[in] cb

Especifica o novo tamanho da matriz de bytes como um número de bytes.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK O tamanho da matriz de bytes foi alterado com êxito.
STG_E_ACCESSDENIED O chamador não tem permissão para acessar a matriz de bytes.
STG_E_MEDIUMFULL O tamanho da matriz de bytes não é alterado porque não há espaço no dispositivo de armazenamento.

Comentários

ILockBytes::SetSize altera o tamanho da matriz de bytes. Se o parâmetro cb for maior que a matriz de bytes atual, a matriz de bytes será estendida para o tamanho indicado preenchendo o espaço intervindo com bytes de valor indefinido, assim como ILockBytes::WriteAt, se o ponteiro seek passar do final do fluxo atual.

Se o parâmetro cb for menor que a matriz de bytes atual, a matriz de bytes será truncada para o tamanho indicado.

Anotações para chamadores

Os chamadores não podem contar com STG_E_MEDIUMFULL sendo retornados no momento apropriado devido ao buffer de cache no sistema operacional ou na rede. No entanto, os chamadores devem ser capazes de lidar com esse código de retorno porque algumas implementações ILockBytes podem dar suporte a ele.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho objidl.h
Biblioteca Uuid.lib
DLL Ole32.dll

Confira também

ILockBytes – Implementação de File-Based

ILockBytes – Implementação de memória global

ILockBytes::ReadAt

ILockBytes::WriteAt