ILockBytes
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa interface é implementado em um objeto matriz byte que é feito por alguns físico armazenamento, such as um arquivo em disco, memória global ou um banco de dados.
Ele é usado por um objeto armazenamento arquivo composto Modelo de Objeto Componente (COM) para fornecer sua acessar armazenamento raiz para o físico dispositivo, ao isolar o armazenamento raiz de detalhes do acessando o físico armazenamento.
Quando a implementar
A maioria dos aplicativos não irá implementar a ILockBytes interface como COM fornece implementações de um dos the most comum situações:
Implementação File-based Se você chamar o StgCreateDocfile função para criar um objeto armazenamento arquivo composto, ele contém uma implementação de ILockBytes que é associado com um matriz de bytes armazenados em um físico arquivo em disco.
As arquivo composto armazenamento objeto chamadas a ILockBytes Métodos. Não chamá-las diretamente nessa implementação.
Há situações em que seria útil para um aplicativo para fornecer sua própria ILockBytes implementação.
De exemplo, um aplicativo banco de dados poderia implementar ILockBytes Para criar um objeto matriz byte feito pelo armazenamento de seu relacional tabelas. No entanto, é altamente recomendável que você usar as implementações com-fornecido.
Para uma discussão das vantagens de usando as implementações COM vez criando seu próprio, consulte o StgCreateDocfileOnILockBytes função, que cria um objeto armazenamento arquivo composto em parte superior de um objeto matriz byte Caller-provided.
Quando usar
O ILockBytes Os métodos são chamado pelas implementações COM o IStorage e IStream As interfaces de objeto arquivo composto.
A menos que você estiver implementando IStorage e IStream, você não precisará chamar ILockBytes Métodos diretamente.
Se você escrever seu próprio ILockBytes implementação, você pode usar o StgCreateDocfileOnILockBytes função para criar um objeto armazenamento arquivo composto feito por sua implementação de ILockBytes.
Métodos
A seguinte tabela mostra os métodos para esta interface no ordem alfabética.
| Método | Descrição |
|---|---|
Garante que qualquer buffers internos mantidos pelo objeto matriz de byte são gravados para o armazenamento de backup. |
|
Restringe acessar para um intervalo especificado de bytes na matriz. |
|
Lê um número especificado de bytes começando um deslocamento especificado a partir do início da matriz. |
|
Altera o tamanho da matriz de byte. |
|
Recupera um STATSTG estrutura para este objeto matriz byte. |
|
Remove a restrição acessar em um intervalo de bytes anteriormente restringidos com ILockBytes::LocRegion. |
|
Grava um número especificado de bytes em uma localidade especificada na matriz. |
Remarks
Para determinar se a plataforma oferece suporte a esta interface, consulte Determinando suporte COM APIs.
Requisitos
| Header | objidl.h, objidl.idl |
| Library | ole32.lib, uuid.lib |
| Windows Embedded CE | Windows CE 2.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |