IShellBrowser::GetViewStateStream 메서드(shobjidl_core.h)

아티클
03/05/2024

뷰별 상태 정보의 스토리지에 사용할 수 있는 IStream 인터페이스를 가져옵니다.

구문

HRESULT GetViewStateStream(
  DWORD   grfMode,
  IStream **ppStrm
);

매개 변수

grfMode

형식:DWORD

IStream 인터페이스의 읽기/쓰기 액세스 다음 값 중 하나일 수 있습니다.

STGM_READ

읽기에 적합한 IStream 을 요청합니다.

STGM_WRITE

쓰기에 적합한 IStream 을 요청합니다.

STGM_READWRITE

읽기 및 쓰기에 적합한 IStream 을 요청합니다.

ppStrm

형식: IStream**

IStream 인터페이스 포인터를 받는 주소입니다.

반환 값

형식: HRESULT

성공하면 S_OK 반환하고, 그렇지 않으면 COM 정의 오류 값을 반환합니다.

설명

이 메서드는 보기의 영구 상태(예: 아이콘 위치, 열 너비 및 현재 스크롤 위치)를 저장하고 복원하는 데 사용됩니다.

호출 애플리케이션에 대한 참고 사항

뷰를 만들 때 GetViewStateStream 을 사용하여 저장된 뷰 상태에서 읽을 수 있으며 보기가 닫혀 있는 경우에도 보기 상태에 대한 변경 내용을 저장합니다. 일반적으로 뷰는 보기 창을 만들 때 STGM_READ, IShellView 인터페이스의 SaveViewState 메서드가 호출되면 STGM_WRITE 사용하여 이 메서드를 호출합니다.

구현자에 대한 참고 사항

각 셸 보기에는 자체 보기 스트림이 있어야 합니다. Windows Explorer 레지스트리에 사용자 단위로 저장되는 가장 최근에 사용한(MRU) 뷰 스트림 목록을 구현합니다.

IShellBrowser도 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	shobjidl_core.h(Shobjidl.h 포함)
DLL	Shell32.dll(버전 4.0 이상)

다음을 통해 공유