Función StgOpenLayoutDocfile (objbase.h)

Artículo
02/29/2024

No compatible.

La función StgOpenLayoutDocfile abre un archivo compuesto en una implementación de ILockBytes que es capaz de supervisar los datos del sector. Para llamar a StgOpenLayoutDocfile, se requieren tanto DfLayout.dll como DfLayout.lib.

Nota No use esta función. En su lugar, use el método IStorage::CopyTo . CopyTo se puede usar para diseñar un archivo de documento, lo que mejora el rendimiento en la mayoría de los escenarios.

Sintaxis

HRESULT StgOpenLayoutDocfile(
  [in]  OLECHAR const *pwcsDfName,
  [in]  DWORD         grfMode,
  [in]  DWORD         reserved,
  [out] IStorage      **ppstgOpen
);

Parámetros

[in] pwcsDfName

Puntero al nombre de cadena Unicode terminado en null del archivo compuesto que se va a abrir.

[in] grfMode

Modo de acceso que se va a usar al abrir el objeto de almacenamiento recién creado. Los valores se toman de las constantes STGM. Tenga en cuenta que no se admiten el modo de prioridad ni las exclusiones. Es probable que el modo de acceso más común sea STGM_DIRECT | STGM_READ | STGM_SHARE_EXCLUSIVE.

[in] reserved

Reservado para uso futuro.

[out] ppstgOpen

Puntero a la variable de puntero IStorage que recibe el puntero de interfaz al objeto raíz del objeto de almacenamiento raíz recién creado.

Valor devuelto

Esta función admite los valores devueltos estándar E_OUTOFMEMORY, E_UNEXPECTED, E_INVALIDARG y E_FAIL, además de lo siguiente:

La función StgOpenLayoutDocfile también puede devolver cualquiera de los valores de error devueltos por la función StgOpenStorageOnILockBytes .

Comentarios

La implementación de archivo compuesto creada por esta función expone la interfaz ILayoutStorage en su almacenamiento raíz. Las aplicaciones usan esta interfaz para expresar el diseño óptimo de sus archivos compuestos con el fin de descargar y representar datos más rápidamente a través de un vínculo lento. StgOpenLayoutDocfile devuelve un puntero a la interfaz IStorage en el almacenamiento raíz del archivo compuesto recién creado. Con este puntero, las aplicaciones llaman a QueryInterface para obtener un puntero a ILayoutStorage.