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
라이브러리	Uuid.lib
DLL	Ole32.dll

추가 정보

ILayoutStorage::ReLayoutDocfile

ILockBytes

StorageLayout