ILayoutStorage::LayoutScript-Methode (objidl.h)
Die LayoutScript-Methode bietet explizite Anweisungen zum Neuanordnen der Speicher, Streams und Steuerelemente in einer Verbunddatei, damit sie der Reihenfolge entsprechen, in der während des Downloads auf sie zugegriffen wird.
Syntax
HRESULT LayoutScript(
[in] StorageLayout *pStorageLayout,
[in] DWORD nEntries,
[in] DWORD glfInterleavedFlag
);
Parameter
[in] pStorageLayout
Zeiger auf ein Array von StorageLayout-Strukturen .
[in] nEntries
Anzahl der Einträge im Array der StorageLayout-Strukturen .
[in] glfInterleavedFlag
Für die zukünftige Verwendung reserviert.
Rückgabewert
Diese Funktion unterstützt die Standardmäßigen Rückgabewerte E_OUTOFMEMORY, E_UNEXPECTED, E_INVALIDARG und E_FAIL sowie Folgendes:
| Rückgabecode | Beschreibung |
|---|---|
| STG_E_INVALIDPOINTER | Der Speicherlayoutzeiger ist ungültig. |
| STG_E_INVALIDFLAG | Der Wert von glfInterleavedFlag ist ungültig. |
| STG_E_PATHNOTFOUND | Der name der neuen Dokumentdatei ist ungültig. |
| STG_E_INSUFFICIENTMEMORY | Es steht nicht genügend Arbeitsspeicher zur Verfügung, um den Vorgang durchzuführen. |
| STG_E_INVALIDPARAMETER | Einer der Parameter ist ungültig. |
| STG_E_INUSE | Die BeginMonitor-Methode wurde aufgerufen, während ILayoutStorage bereits überwacht wurde. |
Hinweise
Um explizite Layoutanweisungen bereitzustellen, ruft die Anwendung ILayoutStorage::LayoutScript auf und übergibt ein Array von StorageLayout-Strukturen . Jede Struktur definiert einen einzelnen Speicher- oder Streamdatenblock und gibt an, wo der Block in das ILockBytes-Bytearray geschrieben werden soll.
Eine Anwendung kann skriptbasiertes Layout mit Überwachung kombinieren, wie es die Struktur einer bestimmten Verbunddatei vorschreibt.
Wenn das optimale Datenlayoutmuster einer gesamten Verbunddatei bestimmt wurde, ruft die Anwendung ILayoutStorage::ReLayoutDocfile auf, um die Verbunddatei so zu strukturieren, dass sie der Reihenfolge entspricht, in der auf ihre Datensektoren zugegriffen wurde.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | objidl.h |
| Bibliothek | Uuid.lib |
| DLL | Ole32.dll |