Compartilhar via


Método INotificationActivationCallback::Activate (notificationactivationcallback.h)

Chamado quando um usuário interage com um sistema na central de ações.

Sintaxe

HRESULT Activate(
  [in] LPCWSTR                            appUserModelId,
  [in] LPCWSTR                            invokedArgs,
  [in] const NOTIFICATION_USER_INPUT_DATA *data,
  [in] ULONG                              count
);

Parâmetros

[in] appUserModelId

O identificador exclusivo que representa seu aplicativo para a plataforma de notificação.

[in] invokedArgs

Argumentos do botão invocado. NULL se o sistema indicar a ativação padrão e nenhum argumento de inicialização tiver sido especificado no conteúdo XML.

[in] data

Os dados dos elementos de entrada disponíveis no sistema de notificação.

[in] count

O número de elementos de dados .

Retornar valor

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

Comentários

Para que seu aplicativo responda a notificações do sistema na central de ações, você precisa substituir esse método em seu aplicativo. Você também precisará criar um atalho no menu Iniciar. Para obter mais informações sobre como responder a notificações de ativação, consulte Responder a ativações do sistema.

Se o aplicativo usar notificações do sistema não interativas, você poderá responder a elas sem usar invokedArgs ou dados.

Se você retornar um código de falha, a ativação falhará e o usuário poderá tentar novamente ativar seu aplicativo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho notificationactivationcallback.h

Confira também

INotificationActivationCallback

Responder a ativações do sistema