Функция StgOpenAsyncDocfileOnIFillLockBytes (objbase.h)

Статья
08/25/2023

[Функция StgOpenAsyncDocfileOnIFillLockBytes устарела. Следующие сведения предоставляются для поддержки версий Windows до Windows 2000.]

StgOpenAsyncDocfileOnIFillLockBytes открывает существующий корневой объект асинхронного хранилища в объекте-оболочке массива байтов, предоставленном вызывающим объектом.

Синтаксис

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

Параметры

[in] pflb

Указатель IFillLockBytes на объект-оболочку массива байтов, содержащий открываемый объект хранилища.

[in] grfMode

Значение типа , указывающее режим доступа, используемый для открытия объекта хранилища. Наиболее распространенным режимом доступа, взятым из констант STGM, является STGM_READ.

[in] asyncFlags

Значение типа , указывающее, наследуется ли точка подключения в хранилище его дочерними хранилищами и потоками. ASYNC_MODE_COMPATIBILITY указывает, что точка подключения наследуется; ASYNC_MODE_DEFAULT указывает, что точка подключения не наследуется.

[out] ppstgOpen

Указатель на переменную указателя IStorage*, которая получает указатель интерфейса на корневой асинхронный объект хранилища.

Возвращаемое значение

Эта функция поддерживает стандартные возвращаемые значения E_OUTOFMEMORY, E_UNEXPECTED, E_INVALIDARG и E_FAIL, а также следующие:

Корневое хранилище объекта асинхронного хранилища открывается в соответствии с режимом доступа в параметре grfMode . Указатель на интерфейс IStorage в открытом объекте хранилища предоставляется с помощью параметра ppstgOpen .

Объект-оболочка массива байтов должен быть ранее создан с помощью вызова функции StgGetIFillLockBytesOnFile .

StgOpenAsyncDocfileOnIFillLockBytes не поддерживает режим доступа с приоритетом или исключения. В противном случае он работает практически так же, как функция StgOpenStorageOnILockBytes .

Возвращаемый объект хранилища имеет точку подключения для IProgressNotify.