ILockBytes – implementação de File-Based

  • Artigo

Implementado em um objeto de matriz de bytes subjacente a um objeto de armazenamento de arquivos composto COM e projetado para ler e gravar diretamente em um arquivo de disco.

Quando usar

Métodos de ILockBytes são chamados das implementações de arquivo composto de IStorage e IStream no objeto de armazenamento de arquivos composto criado por meio de uma chamada para StgCreateDocfile, portanto, você não precisa chamá-los diretamente.

Comentários

Veja a seguir os métodos do ILockBytes File-Based Implementation.

ILockBytes::ReadAt

Lê um bloco de bytes de um deslocamento especificado no início da matriz de bytes.

ILockBytes::WriteAt

Grava um bloco de bytes de um deslocamento especificado no início da matriz de bytes.

ILockBytes::Flush

Garante que todos os buffers internos mantidos pela implementação de ILockBytes sejam gravados no armazenamento físico subjacente.

ILockBytes::SetSize

Define o tamanho da matriz de bytes.

ILockBytes::LockRegion

O parâmetro dwLockTypes é definido como LOCK_ONLYONCE ou LOCK_EXCLUSIVE, o que permitirá ou restringirá o acesso a regiões bloqueadas.

ILockBytes::UnlockRegion

Esse método desbloqueia a região bloqueada por ILockBytes::LockRegion.

ILockBytes::Stat

A implementação IStorage::Stat fornecida por COM chama o método ILockBytes::Stat para recuperar informações sobre o objeto de matriz de bytes. Se não houver um nome razoável para a matriz de bytes, o método ILockBytes::Stat fornecido por COM retornará NULL no membro pwcsName da estrutura STATSTG .

ILockBytes

IStorage

Istream