StgOpenAsyncDocfileOnIFillLockBytes-Funktion (objbase.h)

Artikel
08/25/2023

[Die StgOpenAsyncDocfileOnIFillLockBytes-Funktion ist veraltet. Die folgenden Informationen werden bereitgestellt, um Versionen von Windows vor Windows 2000 zu unterstützen.]

StgOpenAsyncDocfileOnIFillLockBytes öffnet ein vorhandenes asynchrones Stammspeicherobjekt in einem bytearray-Wrapperobjekt, das vom Aufrufer bereitgestellt wird.

Syntax

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

Parameter

[in] pflb

Ein IFillLockBytes-Zeiger auf das Bytearray-Wrapperobjekt, das das zu öffnende Speicherobjekt enthält.

[in] grfMode

Ein -Wert, der den Zugriffsmodus angibt, der zum Öffnen des Speicherobjekts verwendet werden soll. Der gängigste Zugriffsmodus, der aus STGM-Konstanten stammt, ist STGM_READ.

[in] asyncFlags

Ein -Wert, der angibt, ob ein Verbindungspunkt in einem Speicher von seinen Unterspeichern und Streams geerbt wird. ASYNC_MODE_COMPATIBILITY gibt an, dass der Verbindungspunkt geerbt wird. ASYNC_MODE_DEFAULT gibt an, dass der Verbindungspunkt nicht geerbt wird.

[out] ppstgOpen

Ein Zeiger auf die IStorage*-Zeigervariable, die den Schnittstellenzeiger auf das asynchrone Stammspeicherobjekt empfängt.

Rückgabewert

Diese Funktion unterstützt die Standardmäßigen Rückgabewerte E_OUTOFMEMORY, E_UNEXPECTED, E_INVALIDARG und E_FAIL sowie Folgendes:

Hinweise

Der Stammspeicher des asynchronen Speicherobjekts wird entsprechend dem Zugriffsmodus im GrfMode-Parameter geöffnet. Ein Zeiger auf die IStorage-Schnittstelle für das geöffnete Speicherobjekt wird über den ppstgOpen-Parameter bereitgestellt.

Das Bytearray-Wrapperobjekt muss zuvor über einen Aufruf der StgGetIFillLockBytesOnFile-Funktion instanziiert worden sein.

StgOpenAsyncDocfileOnIFillLockBytes unterstützt keinen Prioritätszugriffsmodus oder -ausschlüsse. Andernfalls funktioniert es ähnlich wie die StgOpenStorageOnILockBytes-Funktion .

Das zurückgegebene Speicherobjekt verfügt über einen Verbindungspunkt für IProgressNotify.