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

Weitere Informationen

ILayoutStorage::ReLayoutDocfile

ILockBytes

StorageLayout