ISimpleFrameSite::P reMessageFilter-Methode (ocidl.h)

Artikel
02/29/2024

Bietet einer Website die Möglichkeit, eine Nachricht zu verarbeiten, die vom eigenen Fenster eines Steuerelements empfangen wird, bevor das Steuerelement selbst eine Verarbeitung durchführt.

Syntax

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

Parameter

[in] hWnd

Ein Handle des Steuerelementfensters, das die Nachricht empfängt.

[in] msg

Die von der einfachen Framewebsite empfangene Nachricht.

[in] wp

Der WPARAM der Nachricht.

[in] lp

Die LPARAM der Nachricht.

[out] plResult

Ein Zeiger auf die Variable, die das Ergebnis der Nachrichtenverarbeitung empfängt.

[out] pdwCookie

Ein Zeiger auf die Variable, die an ISimpleFrameSite::P ostMessageFilter übergeben wird, wenn sie später aufgerufen wird. Dieser Parameter sollte nur zugeordnete Daten enthalten, wenn diese Methode S_OK daher auch einen Aufruf von PostMessageFilter erhält, der die Zuordnung freigeben kann. Der Aufrufer ist in keiner Weise für in diesem Parameter zurückgegebene Elemente verantwortlich.

Rückgabewert

Diese Methode kann die folgenden Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Die einfache Framewebsite verwendet die Nachricht in diesem Filter nicht, sodass eine weitere Verarbeitung erfolgen kann.
S_FALSE	Die Website hat die Nachricht verarbeitet, und es sollte keine weitere Verarbeitung erfolgen.
E_NOTIMPL	Die Website führt keine Nachrichtenfilterung durch, was angibt, dass PostMessageFilter später nicht aufgerufen werden muss.
E_POINTER	Die Adresse in plResult oder pdwCookie ist ungültig.

Hinweise

Erfolgreiche Rückgabewerte geben an, ob die Website eine weitere Verarbeitung zulassen möchte. S_OK deutet auf eine weitere Verarbeitung hin, während S_FALSE Mittel nicht weiter verarbeitet werden. S_OK gibt auch an, dass das Steuerelement später PostMessageFilter aufrufen muss.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ocidl.h

Weitere Informationen

ISimpleFrameSite

Freigeben über