IFrameworkInputPane::Advise-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 AdviseWithHWND darin, dass sie über ein Objekt, das ICoreWindow implementiert, auf ihr Fenster verweist.

Syntax

HRESULT Advise(
  [in]  IUnknown                   *pWindow,
  [in]  IFrameworkInputPaneHandler *pHandler,
  [out] DWORD                      *pdwCookie
);

Parameter

[in] pWindow

Typ: IUnknown*

Ein Zeiger auf das Fenster (ein Objekt, das ICoreWindow implementiert), 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::AdviseWithHWND

IFrameworkInputPane::Unadvise