Función StgOpenAsyncDocfileOnIFillLockBytes (objbase.h)

Artículo
02/29/2024

[La función StgOpenAsyncDocfileOnIFillLockBytes está obsoleta. La siguiente información se proporciona para admitir versiones de Windows anteriores a Windows 2000.

StgOpenAsyncDocfileOnIFillLockBytes abre un objeto de almacenamiento asincrónico raíz existente en un objeto contenedor de matriz de bytes proporcionado por el llamador.

Sintaxis

HRESULT StgOpenAsyncDocfileOnIFillLockBytes(
  [in]  IFillLockBytes *pflb,
  [in]  DWORD          grfMode,
  [in]  DWORD          asyncFlags,
  [out] IStorage       **ppstgOpen
);

Parámetros

[in] pflb

Puntero IFillLockBytes al objeto contenedor de matriz de bytes que contiene el objeto de almacenamiento que se va a abrir.

[in] grfMode

Valor que especifica el modo de acceso que se va a usar para abrir el objeto de almacenamiento. El modo de acceso más común, tomado de STGM Constants, es STGM_READ.

[in] asyncFlags

Valor que indica si sus substorages y secuencias heredan un punto de conexión en un almacenamiento. ASYNC_MODE_COMPATIBILITY indica que se hereda el punto de conexión; ASYNC_MODE_DEFAULT indica que el punto de conexión no se hereda.

[out] ppstgOpen

Puntero a la variable de puntero IStorage* que recibe el puntero de interfaz al objeto de almacenamiento asincrónico raíz.

Valor devuelto

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

Comentarios

El almacenamiento raíz del objeto de almacenamiento asincrónico se abre según el modo de acceso en el parámetro grfMode . Se proporciona un puntero a la interfaz IStorage en el objeto de almacenamiento abierto a través del parámetro ppstgOpen .

El objeto contenedor de matriz de bytes debe haberse creado previamente mediante una llamada a la función StgGetIFillLockBytesOnFile .

StgOpenAsyncDocfileOnIFillLockBytes no admite el modo de acceso prioritario ni las exclusiones. De lo contrario, funciona de la misma manera que la función StgOpenStorageOnILockBytes .

El objeto de almacenamiento devuelto tiene un punto de conexión para IProgressNotify.