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 |