SERVICEWIZARDDLGPROC
Aplica-se a: Outlook 2013 | Outlook 2016
Define uma função de retorno de chamada invocada pelo Assistente de Perfil para permitir que um provedor de serviços reaja aos eventos do usuário quando as planilhas de propriedades ou páginas do provedor estão sendo mostradas.
| Propriedade | Valor |
|---|---|
| Arquivo de cabeçalho: |
Mapiwz.h |
| Função definida implementada por: |
Provedores de serviços |
| Função definida chamada por: |
Assistente de perfil MAPI |
BOOL SERVICEWIZARDDLGPROC(
HWND hDlg,
UINT wMsgID,
WPARAM wParam,
LPARAM lParam
);
Parâmetros
hDlg
[in] Identificador de janela para a caixa de diálogo Assistente de Perfil.
wMsgID
[in] A mensagem de janela a ser processada. Além das mensagens de janela regulares esperadas por uma caixa de diálogo modal, as seguintes mensagens podem ser recebidas:
WM_CLOSE
O Assistente de Perfil foi concluído. O provedor de serviços deve fazer toda a limpeza necessária, como desalocar qualquer memória alocada dinamicamente.
WM_COMMAND
Um dos controles do provedor foi selecionado ou o botão Avançar ou Voltar foi clicado. O valor no parâmetro wParam indica qual desses eventos de usuário ocorreu.
WM_INITDIALOG
O usuário mudou para outra página de propriedade, para a qual a caixa de diálogo deve ser inicializada. O provedor deve inicializar os controles que o Assistente de Perfil adicionou à caixa de diálogo.
WIZ_QUERYNUMPAGES
O Assistente de Perfil está solicitando o número de páginas que o provedor precisa exibir. O provedor deve retornar o número de páginas em vez de TRUE ou FALSE. Por exemplo, use a seguinte instrução de retorno para indicar que três páginas devem ser exibidas:
return (BOOL)3;
wParam
[in] Um parâmetro de 32 bits associado a mensagens de janela. Os valores possíveis dependem da mensagem especificada no parâmetro wMsgID . Além dos valores esperados com as mensagens de janela regulares para uma caixa de diálogo modal, os seguintes valores podem ser recebidos:
WIZ_NEXT
Quando o wMsgID contém WM_COMMAND, o usuário clica no botão Avançar .
WIZ_PREV
Quando o wMsgID contém WM_COMMAND, o usuário clica no botão Voltar .
lParam
[in] Um parâmetro de 32 bits associado a mensagens de janela. Os valores possíveis dependem da mensagem especificada no parâmetro wMsgID .
Valor de retorno
O valor retornado por uma função baseada em SERVICEWIZARDDLGPROC depende da mensagem de janela recebida. Observe, em particular, o valor de retorno excepcional da mensagem WIZ_QUERYNUMPAGES. Os valores de retorno normais são:
TRUE
O provedor de serviços processou a mensagem de janela recebida.
FALSE
O provedor de serviços não processou a mensagem de janela recebida.
Comentários
Quando o usuário passa de uma página de propriedade para outra, o provedor é responsável por ocultar os controles da página antiga e mostrar os controles para a página seguinte ou anterior. Quando o usuário clica no botão Avançar , a função baseada em SERVICEWIZARDDLGPROC é chamada com a mensagem WM_COMMAND e WIZ_NEXT no parâmetro wParam . As etapas a seguir descrevem o que ocorre entre a hora em que o usuário clica em Avançar e a hora em que as páginas de configuração do primeiro provedor são renderizadas.
O Assistente de Perfil oculta todos os controles que estão na janela.
O Assistente de Perfil adiciona os controles ocultos do provedor à página.
O Assistente de Perfil chama SERVICEWIZARDDLGPROC, enviando a mensagem WM_INITDIALOG, para que o provedor possa inicializar os controles.
O Assistente de Perfil chama SERVICEWIZARDDLGPROC, enviando a mensagem WIZ_QUERYNUMPAGES. O provedor retorna o número de páginas que devem ser mostradas.
O Assistente de Perfil chama SERVICEWIZARDDLGPROC, enviando a mensagem WM_COMMAND com o parâmetro wParam definido como WIZ_NEXT ou WIZ_PREV. Neste ponto, o provedor retorna FALSE {error} ou revela seus controles e retorna TRUE {success}. Se o Assistente de Perfil passar em ID_NEXT, a primeira página do provedor será exibida. Se ID_PREV for passada, a última página será exibida.
O Assistente de Perfil chama a função SERVICEWIZARDDDDLGPROC do provedor, enviando a mensagem WM_COMMAND com o parâmetro wParam definido como WIZ_NEXT ou WIZ_PREV (dependendo de qual botão o usuário clicou). O provedor é responsável por mostrar ou ocultar seus controles e gravar seus dados no IMAPIProp passados para o Assistente de Perfil para percorrer sua sequência de páginas. O provedor deve retornar TRUE se a página seguinte ou anterior tiver sido mostrada com êxito e FALSE se nem a próxima nem a página anterior puderem ser mostradas. O provedor precisa estar ciente de quando está saindo de sua sequência de páginas e responder adequadamente escondendo seus controles e escrevendo seus dados no perfil.
Se o usuário sair do intervalo de páginas do provedor, o Assistente de Perfil excluirá os controles ocultos do provedor da caixa de diálogo e chamará o próximo provedor ou exibirá sua próxima página se esse for o último provedor.