WAP Wakeup Using a Generic Application Wakeup API

9/19/2008

Esse recurso permite que os aplicativos desligamento e, em seguida, continuar ou iniciar quando um pacote WAP (binário datagramas) chegam pela curta mensagem Service (SMS). Você implementar esse recurso usando um modelo wakeup/Notify aplicativo genérico ou usando o API.

API

O Registro sistema expõe a interface. Você precisa uma chave exclusiva para as entradas a seguinte tabela para cada porta que um aplicativo registra para uma ativação WAP. Número de porta em decimal forma deve estar presente na chave Registro próprio.

[HKLM\Software\Microsoft\Shell\Event\Network\WDP\<port 1>\<app key>]
...
[HKLM\Software\Microsoft\Shell\Event\Network\WDP\<port2>\<app key >]
...

A seguinte tabela mostra as entradas Registro.

Valor : tipo	Descrição
Classe : seqüência de caracteres	Classe de janela de escuta do aplicativo, que é a janela destino para a mensagem WDP/SMS
Comando : seqüência de caracteres	WDP caminho do aplicativo cliente para iniciar o aplicativo quando ele estiver inativo.
NotifyOnLaunch : DWORD	Mensagens associado com a porta WDP que será postada para Listener Window Class quando chega a mensagem WDP. Se o aplicativo não estiver registrado com a camada WDP, em seguida, a mensagem será postada. Se o aplicativo não é carregado, em seguida, o aplicativo será iniciado. Se chave não está presente no Registro e o aplicativo não está ativo e, em seguida, o aplicativo será iniciado, mas não há mensagens serão postadas para a classe de janela de escuta.
< porta WDP > : DWORD	Representa a mensagem janela que será publicada para a janela da classe Listener Window especificado. Este valor do Registro é um par mensagem porta e janela. O < porta WDP > Representa a porta WDP, O aplicativo é responsável por mapeamento a mensagem para o número porta WDP.

Exemplos

Aplicativo xadrez:

O seguinte exemplo mostra como um aplicativo exemplo registra para ser notificado e iniciado uma mensagem WDP chega em ambos os < WDPport1 > Ou < WDPport2 >.

HKEY_LOCAL_MACHINE\Software\Microsoft\Shell\Event\Network\WDP\<WDPport1>\chess
   "Class"=string:ListenerWnd
   "Command"=string:chess.exe
   "NotifyOnLaunch"=dword:1
   "<WDPport1>"=dword:<app msg e.g. value of WM_APP+Num1>

HKEY_LOCAL_MACHINE\Software\Microsoft\Shell\Event\Network\WDP\<WDPport2>\chess
   "Class"=string:ListenerWnd
   "Command"=string:chess.exe
   "NotifyOnLaunch"=dword:1
    "<WDPport2>"=dword:<app msg e.g. value of WM_APP+Num2>

O seguinte cenário descreve a seqüência de eventos para um aplicativo Application.The xadrez Chess.exe é fechado mas ele deve poderá receber mensagens SMS WDP no WDPport1 e WDPport2.

1. Crie a configuração Registro.
2. Um mensagens SMS WDP chega a camada WDP na porta WDPport1.
3. A camada WDP verifica se o aplicativo está registrado com a camada WDP em Port Number WDPport1. Este maiúsculas e minúsculas, nenhum aplicativo está registrado.
4. O aplicativo verifica o Registro determinar que se qualquer aplicativo está registrado para mensagens WDP no WDPport1. de porta, O aplicativo localiza esse aplicativo Chess.exe está registrado.
5. Se Chess.exe é carregado, o aplicativo inicia Chess.exe.
6. Abre o aplicativo Xadrez "ListenerWnd" Classe de janela de escuta.
7. "ListenerWnd" Recebe uma mensagem com valor DWORD < WM_APP+Num1 >
8. Chess.exe reconhece esta mensagem como uma indicação de que uma mensagem WDP está aguardando na porta WDPport1 e registra WDPport1 como é próprio com a camada WDP.
9. Chess.exe recebe e processa a mensagem WDP aguardando.
10. Chess.exe fecha.

Design de aplicativos do cliente FAQ

P: Como fazer você resolver conflito se múltiplo registrar aplicativos para a mesma porta?

R: Aplicativos devem verificar o Registro em seus próprios para garantir que eles 'Proprietário' a porta.

P: Pode registrar os aplicativos para uma intervalo de portas?

R: Não, os aplicativos devem registrar cada porta individualmente.

P: Quando um WDP/datagrama UDP chega, pode-iniciar ou notificar um aplicativo?

R: Não, um aplicativo só pode ser iniciado ou notificado quando WDP datagramas cheguem sobre a transmissão do SMS.

P: É possível usar qualquer número porta WDP?

R: O número de portas usadas deve ser mantido no mínimo. As diretrizes sobre o uso porta WDP definido na especificação de WDP devem ser seguidas. Você pode localizar a diretriz no fórum do WAP, www.wapforum.org no momento.

Rede

A seguinte lista mostra os com suporte redes:

• Qualquer rede que oferece suporte a WAP através do SMS.
• No momento só GSM

See Also

Concepts

WAP Wakeup