ILayoutStorage::LayoutScript 方法 (objidl.h)

LayoutScript 方法提供明確指示,以重新排序複合檔案中的記憶體、數據流和控件,以符合下載期間存取它們的順序。

語法

HRESULT LayoutScript(
  [in] StorageLayout *pStorageLayout,
  [in] DWORD         nEntries,
  [in] DWORD         glfInterleavedFlag
);

參數

[in] pStorageLayout

StorageLayout 結構的陣列指標。

[in] nEntries

StorageLayout 結構陣列中的項目數。

[in] glfInterleavedFlag

保留供未來使用。

傳回值

此函式支援標準傳回值E_OUTOFMEMORY、E_UNEXPECTED、E_INVALIDARG和E_FAIL,以及下列各項:

傳回碼 Description
STG_E_INVALIDPOINTER 記憶體配置指標無效。
STG_E_INVALIDFLAG glfInterleavedFlag 的值無效。
STG_E_PATHNOTFOUND 指定的新檔案檔名無效。
STG_E_INSUFFICIENTMEMORY 記憶體不足,無法完成此作業。
STG_E_INVALIDPARAMETER 其中一個參數無效。
STG_E_INUSE ILayoutStorage 已經監視時,呼叫 BeginMonitor 方法。

備註

為了提供明確的版面配置指示,應用程式會呼叫 ILayoutStorage::LayoutScript,並傳遞 StorageLayout 結構的數位。 每個結構都會定義單一記憶體或數據流數據區塊,並指定要在 ILockBytes 位元組陣列中寫入區塊的位置。

應用程式可以結合腳本配置與監視,因為特定複合檔案的結構可能會指定。

判斷整個複合檔案的最佳數據配置模式時,應用程式會呼叫 ILayoutStorage::ReLayoutDocfile 來 重新建構複合檔案,以符合其數據扇區存取的順序。

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 objidl.h
程式庫 Uuid.lib
Dll Ole32.dll

另請參閱

ILayoutStorage::ReLayoutDocfile

ILockBytes

StorageLayout