IFrameworkInputPane::AdviseWithHWND-Methode (shobjidl_core.h)

Registriert das Handlerobjekt des Eingabebereichs der App, um Benachrichtigungen im Namen eines Fensters zu empfangen, wenn ein Ereignis den Eingabebereich auslöst. Diese Methode unterscheidet sich von Advise darin, dass sie auf ihr Fenster über einen HWND verweist.

Syntax

HRESULT AdviseWithHWND(
  [in]  HWND                       hwnd,
  [in]  IFrameworkInputPaneHandler *pHandler,
  [out] DWORD                      *pdwCookie
);

Parameter

[in] hwnd

Typ: HWND

Das Handle des Fensters, für das der Handler auf Eingabebereichsereignisse lauschen soll.

[in] pHandler

Typ: IFrameworkInputPaneHandler*

Ein IFrameworkInputPaneHandler-Schnittstellenzeiger auf den Handler instance für diese App.

[out] pdwCookie

Typ: DWORD*

Ein Zeiger auf einen Wert, der nach erfolgreicher Rückgabe dieser Methode ein Cookie für empfängt, das später verwendet werden kann, um die Registrierung des Handlers über die Unadvise-Methode aufzuheben.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (shobjidl.h einschließen)

Weitere Informationen

IFrameworkInputPane

IFrameworkInputPane::Advise

IFrameworkInputPane::Unadvise