StgOpenLayoutDocfile 함수(objbase.h)

아티클
02/29/2024

지원되지 않습니다.

StgOpenLayoutDocfile 함수는 섹터 데이터를 모니터링할 수 있는 ILockBytes 구현에서 복합 파일을 엽니다. StgOpenLayoutDocfile을 호출하려면 DfLayout.dll 및 DfLayout.lib가 모두 필요합니다.

참고 이 함수를 사용하지 마세요. 대신 IStorage::CopyTo 메서드를 사용합니다. CopyTo 를 사용하여 문서 파일을 레이아웃할 수 있으므로 대부분의 시나리오에서 성능이 향상됩니다.

구문

HRESULT StgOpenLayoutDocfile(
  [in]  OLECHAR const *pwcsDfName,
  [in]  DWORD         grfMode,
  [in]  DWORD         reserved,
  [out] IStorage      **ppstgOpen
);

매개 변수

[in] pwcsDfName

열 복합 파일의 null로 끝나는 유니코드 문자열 이름에 대한 포인터입니다.

[in] grfMode

새로 만든 스토리지 개체를 열 때 사용할 액세스 모드입니다. 값은 STGM 상수에서 가져옵니다. 우선 순위 모드 및 제외는 지원되지 않습니다. 가장 일반적인 액세스 모드는 STGM_DIRECT 수 있습니다. | STGM_READ | STGM_SHARE_EXCLUSIVE.

[in] reserved

다음에 사용하도록 예약됩니다.

[out] ppstgOpen

새로 만든 루트 스토리지 개체의 루트 개체에 대한 인터페이스 포인터를 수신하는 IStorage 포인터 변수에 대한 포인터입니다.

반환 값

이 함수는 다음 외에도 표준 반환 값 E_OUTOFMEMORY, E_UNEXPECTED, E_INVALIDARG 및 E_FAIL 지원합니다.

StgOpenLayoutDocfile 함수는 StgOpenStorageOnILockBytes 함수에서 반환하는 오류 값을 반환할 수도 있습니다.

설명

이 함수에서 만든 복합 파일 구현은 루트 스토리지에 ILayoutStorage 인터페이스를 노출합니다. 애플리케이션은 느린 링크를 통해 데이터를 더 빠르게 다운로드하고 렌더링하기 위해 이 인터페이스를 사용하여 복합 파일의 최적의 레이아웃을 표현합니다. StgOpenLayoutDocfile 은 새로 만든 복합 파일의 루트 스토리지에 있는 IStorage 인터페이스에 대한 포인터를 반환합니다. 애플리케이션은 이 포인터를 사용하여 QueryInterface 를 호출하여 ILayoutStorage에 대한 포인터를 가져옵니다.