IPreviewHandlerFrame::GetWindowContext 메서드(shobjidl_core.h)

미리 보기 호스트의 바로 가기 키 목록을 가져옵니다.

구문

HRESULT GetWindowContext(
  [out] PREVIEWHANDLERFRAMEINFO *pinfo
);

매개 변수

[out] pinfo

형식: PREVIEWHANDLERFRAMEINFO*

가속기 테이블 정보를 수신하는 PREVIEWHANDLERFRAMEINFO 구조체에 대한 포인터입니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

가속기 테이블은 바로 가기 키와 호스트가 실행해야 하는 명령의 목록입니다. 최적화로 미리 보기 처리기는 수신하는 키 입력을 보고, 가속기 테이블에 검사 호스트가 관심이 있는지 확인하고, 적절한 경우 구조체의 명령을 무시하고 전달할 수 있습니다. IPreviewHandlerFrame::GetWindowContext에서 반환된 가속기 테이블은 키 입력만 포함하며 유효한 명령 항목을 포함하지 않습니다. 미리 보기 처리기는 이 최적화를 건너뛰고 모든 키 입력에 대해 IPreviewHandlerFrame::TranslateAccelerator 를 호출하기만 하면 됩니다. 미리 보기 처리기가 제거되면 DestroyAcceleratorTable 함수를 사용하여 가속기 테이블을 해제해야 합니다.

이 메서드는 미리 보기 처리기가 SetSite 를 호출하고 결과가 나중에 미리 보기 처리기에서 사용하기 위해 캐시된 시점에 호출되어야 합니다. 이 메서드는 낮은 무결성 모드에서 실행되는 미리 보기 처리기에서 호출할 수 없습니다. 이러한 미리 보기 처리기는 모든 키 입력에 대해 항상 IPreviewHandlerFrame::TranslateAccelerator 를 호출해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista, Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shobjidl_core.h(Shobjidl.h 포함)
재배포 가능 파일	Windows Search 4 이상

추가 정보

IPreviewHandlerFrame

IPreviewHandlerFrame::TranslateAccelerator