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

El método LayoutScript proporciona instrucciones explícitas para reordenar los almacenamientos, secuencias y controles de un archivo compuesto para que coincidan con el orden en que se accede a ellos durante la descarga.

Sintaxis

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

Parámetros

[in] pStorageLayout

Puntero a una matriz de estructuras StorageLayout .

[in] nEntries

Número de entradas de la matriz de estructuras StorageLayout .

[in] glfInterleavedFlag

Reservado para uso futuro.

Valor devuelto

Esta función admite los valores devueltos estándar E_OUTOFMEMORY, E_UNEXPECTED, E_INVALIDARG y E_FAIL, así como lo siguiente:

Código devuelto	Descripción
STG_E_INVALIDPOINTER	El puntero de diseño de almacenamiento no es válido.
STG_E_INVALIDFLAG	El valor de glfInterleavedFlag no es válido.
STG_E_PATHNOTFOUND	El nuevo nombre de archivo de documento especificado no es válido.
STG_E_INSUFFICIENTMEMORY	no hay suficiente memoria para completar la operación.
STG_E_INVALIDPARAMETER	Uno de los parámetros no es válido.
STG_E_INUSE	Se llamó al método BeginMonitor mientras ILayoutStorage ya estaba supervisando.

Comentarios

Para proporcionar instrucciones de diseño explícitas, la aplicación llama a ILayoutStorage::LayoutScript, pasando una matriz de estructuras StorageLayout . Cada estructura define un único bloque de datos de almacenamiento o flujo y especifica dónde se va a escribir el bloque en la matriz de bytes ILockBytes .

Una aplicación puede combinar el diseño con scripts con la supervisión, ya que la estructura de un archivo compuesto determinado puede dictar.

Cuando se determina el patrón óptimo de diseño de datos de un archivo compuesto completo, la aplicación llama a ILayoutStorage::ReLayoutDocfile para reestructurar el archivo compuesto para que coincida con el orden en que se tuvo acceso a sus sectores de datos.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	objidl.h
Library	Uuid.lib
Archivo DLL	Ole32.dll

Consulte también

ILayoutStorage::ReLayoutDocfile

ILockBytes

StorageLayout