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 |