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