ILockBytes – Implementação global de memória

A implementação de memória global do 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

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.

Observações

Veja a seguir os métodos do ILockBytes Global Memory Implementation.

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 está 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 do 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 nenhum nome razoável para a matriz de bytes, o método ILockBytes::Stat fornecido por COM retornará NULL no membro pwcsName da estruturaSTATSTG.

Tópicos relacionados

ILockBytes

IStorage

IStream