다음을 통해 공유

ISimpleFrameSite::P reMessageFilter 메서드(ocidl.h)

  • 아티클

컨트롤 자체가 처리를 수행하기 전에 컨트롤의 자체 창에서 받은 메시지를 처리할 수 있는 기회를 사이트에 제공합니다.

구문

HRESULT PreMessageFilter(
  [in]  HWND    hWnd,
  [in]  UINT    msg,
  [in]  WPARAM  wp,
  [in]  LPARAM  lp,
  [out] LRESULT *plResult,
  [out] DWORD   *pdwCookie
);

매개 변수

[in] hWnd

메시지를 받는 컨트롤 창의 핸들입니다.

[in] msg

간단한 프레임 사이트에서 받은 메시지입니다.

[in] wp

메시지의 WPARAM 입니다.

[in] lp

메시지의 LPARAM 입니다.

[out] plResult

메시지 처리 결과를 수신하는 변수에 대한 포인터입니다.

[out] pdwCookie

나중에 호출되는 경우 ISimpleFrameSite::P ostMessageFilter 에 전달될 변수에 대한 포인터입니다. 이 매개 변수는 이 메서드가 S_OK 반환하는 경우에만 할당된 데이터를 포함해야 하므로 할당을 해제할 수 있는 PostMessageFilter 에 대한 호출도 수신됩니다. 호출자는 이 매개 변수에서 반환된 모든 항목에 대해 어떠한 책임도 지지 않습니다.

반환 값

이 메서드는 다음 값을 반환할 수 있습니다.

반환 코드 Description
S_OK
 간단한 프레임 사이트에서는 이 필터의 메시지를 사용하지 않으므로 더 많은 처리가 수행될 수 있습니다.
S_FALSE
 사이트에서 메시지를 처리했으며 추가 처리가 수행되지 않습니다.
E_NOTIMPL
 사이트에서는 PostMessageFilter를 나중에 호출할 필요가 없음을 나타내는 메시지 필터링을 수행하지 않습니다.
E_POINTER
 plResult 또는 pdwCookie의 주소가 잘못되었습니다.

설명

반환 값이 성공하면 사이트에서 추가 처리를 허용할지 여부를 나타냅니다. S_OK 추가 처리를 나타내는 반면, S_FALSE 의미는 더 이상 처리하지 않습니다. 또한 S_OK 컨트롤이 나중에 PostMessageFilter를 호출해야 했음을 나타냅니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 ocidl.h

추가 정보

ISimpleFrameSite