Método IFrameworkInputPane::Advise (shobjidl_core.h)

Registra o objeto do manipulador do painel de entrada do aplicativo para receber notificações em nome de uma janela quando um evento dispara o painel de entrada. Esse método difere de AdviseWithHWND , pois faz referência à janela por meio de um objeto que implementa ICoreWindow.

Sintaxe

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

Parâmetros

[in] pWindow

Tipo: IUnknown*

Um ponteiro para a janela (um objeto que implementa ICoreWindow) para o qual o manipulador deve escutar eventos do painel de entrada.

[in] pHandler

Tipo: IFrameworkInputPaneHandler*

Um ponteiro de interface IFrameworkInputPaneHandler para a instância do manipulador para este aplicativo.

[out] pdwCookie

Tipo: DWORD*

Um ponteiro para um valor que, quando esse método retorna com êxito, recebe um cookie para o qual pode ser usado posteriormente para cancelar o registro do manipulador por meio do método Unadvise .

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shobjidl_core.h (inclua Shobjidl.h)

Confira também

IFrameworkInputPane

IFrameworkInputPane::AdviseWithHWND

IFrameworkInputPane::Unadvise