Método ILayoutStorage::LayoutScript (objidl.h)

  • Artigo

O método LayoutScript fornece instruções explícitas para reordenar os armazenamentos, fluxos e controles em um arquivo composto para corresponder à ordem em que são acessados durante o download.

Sintaxe

HRESULT LayoutScript(
  [in] StorageLayout *pStorageLayout,
  [in] DWORD         nEntries,
  [in] DWORD         glfInterleavedFlag
);

Parâmetros

[in] pStorageLayout

Ponteiro para uma matriz de estruturas StorageLayout .

[in] nEntries

Número de entradas na matriz de estruturas StorageLayout .

[in] glfInterleavedFlag

Reservado para uso futuro.

Retornar valor

Essa função dá suporte aos valores retornados padrão E_OUTOFMEMORY, E_UNEXPECTED, E_INVALIDARG e E_FAIL, bem como o seguinte:

Código de retorno Descrição
STG_E_INVALIDPOINTER O ponteiro de layout de armazenamento é inválido.
STG_E_INVALIDFLAG O valor de glfInterleavedFlag é inválido.
STG_E_PATHNOTFOUND O novo nome de arquivo de documento especificado é inválido.
STG_E_INSUFFICIENTMEMORY Não há memória suficiente para concluir a operação.
STG_E_INVALIDPARAMETER Um dos parâmetros é inválido.
STG_E_INUSE O método BeginMonitor foi chamado enquanto ILayoutStorage já estava monitorando.

Comentários

Para fornecer instruções de layout explícitas, o aplicativo chama ILayoutStorage::LayoutScript, passando uma matriz de estruturas StorageLayout . Cada estrutura define um único bloco de dados de armazenamento ou fluxo e especifica onde o bloco deve ser gravado na matriz de bytes ILockBytes .

Um aplicativo pode combinar o layout com script com o monitoramento, como a estrutura de um arquivo composto específico pode ditar.

Quando o padrão de layout de dados ideal de um arquivo composto inteiro foi determinado, o aplicativo chama ILayoutStorage::ReLayoutDocfile para reestruturar o arquivo composto para corresponder à ordem em que seus setores de dados foram acessados.

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

ILayoutStorage::ReLayoutDocfile

ILockBytes

StorageLayout