Funzione StgOpenLayoutDocfile (objbase.h)

Articolo
03/05/2024

Non supportato.

La funzione StgOpenLayoutDocfile apre un file composto in un'implementazione ILockBytes in grado di monitorare i dati del settore. Per chiamare StgOpenLayoutDocfile, sono necessari sia DfLayout.dll che DfLayout.lib.

Nota Non usare questa funzione. Usare invece il metodo IStorage::CopyTo . CopyTo può essere usato per il layout di un docfile, migliorando così le prestazioni nella maggior parte degli scenari.

Sintassi

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

Parametri

[in] pwcsDfName

Puntatore al nome della stringa Unicode con terminazione Null del file composto da aprire.

[in] grfMode

Modalità di accesso da utilizzare quando si apre l'oggetto di archiviazione appena creato. I valori vengono ricavati dalle costanti STGM. Tenere presente che la modalità di priorità e le esclusioni non sono supportate. È probabile che la modalità di accesso più comune sia STGM_DIRECT | STGM_READ | STGM_SHARE_EXCLUSIVE.

[in] reserved

Riservato per utilizzi futuri.

[out] ppstgOpen

Puntatore alla variabile del puntatore IStorage che riceve il puntatore dell'interfaccia all'oggetto radice dell'oggetto di archiviazione radice appena creato.

Valore restituito

Questa funzione supporta i valori restituiti standard E_OUTOFMEMORY, E_UNEXPECTED, E_INVALIDARG e E_FAIL, oltre ai seguenti:

La funzione StgOpenLayoutDocfile può restituire anche tutti i valori di errore restituiti dalla funzione StgOpenStorageOnILockBytes .

Commenti

L'implementazione di file composta creata da questa funzione espone l'interfaccia ILayoutStorage nella relativa risorsa di archiviazione radice. Le applicazioni usano questa interfaccia per esprimere il layout ottimale dei file composti per scaricare ed eseguire il rendering dei dati più rapidamente su un collegamento lento. StgOpenLayoutDocfile restituisce un puntatore all'interfaccia IStorage nell'archiviazione radice del file composto appena creato. Usando questo puntatore, le applicazioni chiamano QueryInterface per ottenere un puntatore a ILayoutStorage.