Funzione StgOpenAsyncDocfileOnIFillLockBytes (objbase.h)

Articolo
03/05/2024

[La funzione StgOpenAsyncDocfileOnIFillLockBytes è obsoleta . Le informazioni seguenti vengono fornite per supportare le versioni di Windows precedenti a Windows 2000.]

StgOpenAsyncDocfileOnIFillLockBytes apre un oggetto di archiviazione asincrona radice esistente in un oggetto wrapper di byte fornito dal chiamante.

Sintassi

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

Parametri

[in] pflb

Puntatore IFillLockBytes all'oggetto wrapper di matrice byte che contiene l'oggetto di archiviazione da aprire.

[in] grfMode

Valore che specifica la modalità di accesso da usare per aprire l'oggetto di archiviazione. La modalità di accesso più comune, presa da COSTANTI STGM, è STGM_READ.

[in] asyncFlags

Valore che indica se un punto di connessione in un archivio viene ereditato dai relativi sottostorage e flussi. ASYNC_MODE_COMPATIBILITY indica che il punto di connessione viene ereditato; ASYNC_MODE_DEFAULT indica che il punto di connessione non viene ereditato.

[out] ppstgOpen

Variabile puntatore a IStorage* che riceve il puntatore dell'interfaccia all'oggetto di archiviazione asincrona radice.

Valore restituito

Questa funzione supporta i valori restituiti standard E_OUTOFMEMORY, E_UNEXPECTED, E_INVALIDARG e E_FAIL, nonché i seguenti:

Commenti

L'archiviazione radice dell'oggetto di archiviazione asincrona viene aperta in base alla modalità di accesso nel parametro grfMode . Viene fornito un puntatore all'interfaccia IStorage nell'oggetto di archiviazione aperto tramite il parametro ppstgOpen .

L'oggetto wrapper della matrice di byte deve essere stato creato in precedenza tramite una chiamata alla funzione StgGetIFillLockBytesOnFile .

StgOpenAsyncDocfileOnIFillLockBytes non supporta la modalità di accesso con priorità o le esclusioni. In caso contrario, funziona in modo molto simile alla funzione StgOpenStorageOnILockBytes .

L'oggetto di archiviazione restituito ha un punto di connessione per IProgressNotify.