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をサポートします。また、次に示します。
| リターン コード | 説明 |
|---|---|
| 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 Professional [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | objidl.h |
| Library | Uuid.lib |
| [DLL] | Ole32.dll |