Compartilhar via


ILockBytes – Implementação de memória global

A implementação de memória global ILockBytes é implementada em um objeto de matriz de bytes subjacente a um objeto de armazenamento de arquivos composto COM e projetada para ler e gravar diretamente na memória global.

Quando usar

Os 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.

Comentários

Veja a seguir os métodos da Implementação de Memória Global do ILockBytes .

ILockBytes::ReadAt

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

ILockBytes::WriteAt

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

ILockBytes::Flush

Ao contrário da implementação baseada em arquivo, chamar esse método na implementação de memória global não tem efeito.

ILockBytes::SetSize

Define o tamanho da matriz de bytes.

ILockBytes::LockRegion

Essa implementação não dá suporte ao bloqueio, portanto , dwLocksType é definido como zero. O chamador deve garantir que os acessos sejam válidos e mutuamente exclusivos.

ILockBytes::UnlockRegion

Essa implementação não dá suporte ao bloqueio.

ILockBytes::Stat

A implementação IStorage::Stat fornecida por COM chama o método ILockBytes::Stat para recuperar dados 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