Metodo ILayoutStorage::LayoutScript (objidl.h)
Il metodo LayoutScript fornisce indicazioni esplicite per riordinare le risorse di archiviazione, i flussi e i controlli in un file composto in modo che corrispondano all'ordine in cui si accede durante il download.
Sintassi
HRESULT LayoutScript(
[in] StorageLayout *pStorageLayout,
[in] DWORD nEntries,
[in] DWORD glfInterleavedFlag
);
Parametri
[in] pStorageLayout
Puntatore a una matrice di strutture StorageLayout .
[in] nEntries
Numero di voci nella matrice di strutture StorageLayout .
[in] glfInterleavedFlag
Riservato per utilizzi futuri.
Valore restituito
Questa funzione supporta i valori restituiti standard E_OUTOFMEMORY, E_UNEXPECTED, E_INVALIDARG e E_FAIL, nonché i seguenti:
| Codice restituito | Descrizione |
|---|---|
| STG_E_INVALIDPOINTER | Il puntatore al layout di archiviazione non è valido. |
| STG_E_INVALIDFLAG | Il valore di glfInterleavedFlag non è valido. |
| STG_E_PATHNOTFOUND | Il nuovo nome file di documento specificato non è valido. |
| STG_E_INSUFFICIENTMEMORY | Memoria insufficiente per completare l'operazione. |
| STG_E_INVALIDPARAMETER | Uno dei parametri non è valido. |
| STG_E_INUSE | Il metodo BeginMonitor è stato chiamato mentre ILayoutStorage stava già monitorando. |
Commenti
Per fornire istruzioni di layout esplicite, l'applicazione chiama ILayoutStorage::LayoutScript, passando una matrice di strutture StorageLayout . Ogni struttura definisce un singolo blocco di dati di archiviazione o flusso e specifica dove deve essere scritto il blocco nella matrice di byte ILockBytes .
Un'applicazione può combinare il layout con script con il monitoraggio, perché la struttura di un file composto specifico può dettare.
Quando è stato determinato il modello di layout dei dati ottimale di un intero file composto, l'applicazione chiama ILayoutStorage::ReLayoutDocfile per ristrutturare il file composto in modo che corrisponda all'ordine in cui è stato eseguito l'accesso ai relativi settori di dati.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [app desktop | App UWP] |
| Server minimo supportato | Windows 2000 Server [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | objidl.h |
| Libreria | Uuid.lib |
| DLL | Ole32.dll |