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) |