Método ILayoutStorage::LayoutScript (objidl.h)
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 |