Freigeben über


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