LAUNCHWIZARDENTRY
Aplica-se a: Outlook 2013 | Outlook 2016
Define uma função que inicia o aplicativo Assistente de Perfil com a finalidade de adicionar um ou mais serviços de mensagem a um perfil.
| Propriedade | Valor |
|---|---|
| Arquivo de cabeçalho: |
Mapiwz.h |
| Função definida implementada por: |
MAPI |
| Função definida chamada por: |
Aplicativos do cliente |
HRESULT LAUNCHWIZARDENTRY(
HWND hParentWnd,
ULONG ulFlags,
LPCSTR FAR * lppszServiceNameToAdd,
ULONG cbBufferMax,
LPSTR lpszNewProfileName
);
Parâmetros
hParentWnd
[in] Um identificador para a janela pai do chamador. Se o chamador não tiver uma janela pai, o parâmetro hParentWnd deverá ser NULL.
ulFlags
[in] Bitmask de sinalizadores indicando opções para o Assistente de Perfil. Os seguintes sinalizadores podem ser definidos:
MAPI_PW_ADD_SERVICE_ONLY
O Assistente de Perfil deve adicionar apenas os serviços de mensagem listados por meio do parâmetro lppszServiceNameToAdd e não exibir sua página para selecionar serviços de mensagem.
MAPI_PW_FIRST_PROFILE
O perfil a ser criado é o primeiro para esta estação de trabalho.
MAPI_PW_HIDE_SERVICES_LIST
A página do Assistente de Perfil para selecionar serviços de mensagem não deve ser exibida.
MAPI_PW_LAUNCHED_BY_CONFIG
O Assistente de Perfil foi iniciado pelo aplicativo de configuração Painel de Controle.
MAPI_PW_PROVIDER_UI_ONLY
Somente as caixas de diálogo de configuração dos provedores de serviços devem ser exibidas e as páginas do Assistente de Perfil não devem ser exibidas. Esse sinalizador só poderá ser definido se o sinalizador MAPI_PW_ADD_SERVICE_ONLY estiver definido.
lppszServiceNameToAdd
[in] Ponteiro para uma matriz de cadeias de caracteres que contém os nomes dos serviços de mensagem a serem adicionados ao perfil. A matriz deve ser encerrada com um valor NULL.
cbBufferMax
[in] Tamanho do buffer apontado pelo parâmetro lpszNewProfileName .
lpszNewProfileName
[out] Ponteiro para um buffer de cadeia de caracteres em que a função baseada em LAUNCHWIZARDENTRY retorna o nome do perfil criado.
Valor de retorno
S_OK
A chamada foi bem-sucedida e retornou o valor ou valores esperados.
MAPI_E_CALL_FAILED
Um erro de origem inesperada ou desconhecida impediu a conclusão da operação. As possibilidades incluem falha ao inicializar o subsistema MAPI para o Assistente de Perfil, a incapacidade de acessar o perfil padrão e um retorno de erro da caixa de diálogo.
Comentários
A implementação MAPI do protótipo da função LAUNCHWIZARDENTRY é o ponto de entrada no aplicativo Assistente de Perfil MAPI. MAPI nomeia esse ponto de entrada LaunchWizard.
Quando o sinalizador MAPI_PW_ADD_SERVICE_ONLY é definido no parâmetro ulFlags, as seguintes regras se aplicam:
O sinalizador MAPI_PW_LAUNCHED_BY_CONFIG inibe que a página de boas-vindas seja exibida.
Os sinalizadores MAPI_PW_HIDE_SERVICES_LIST e MAPI_PW_PROVIDER_UI_ONLY são úteis somente quando não há um perfil padrão. Nesse caso, esses sinalizadores determinam qual página do Assistente de Perfil deve ser exibida.
Se houver um perfil padrão, nenhuma das páginas do Assistente de Perfil será exibida.
Se existir um perfil padrão, apenas um serviço de mensagem será listado por meio do parâmetro lppszServiceNameToAdd e esse serviço de mensagem já estiver no perfil padrão, o Assistente de Perfil retornará S_OK sem adicionar nada ao perfil.
Para que cada serviço de mensagem seja adicionado ao perfil, o Assistente de Perfil chama a função de ponto de entrada do serviço com base no protótipo MSGSERVICEENTRY . Para cada provedor de serviços selecionado em um serviço de mensagem a ser adicionado ao perfil, o Assistente de Perfil chama a função de ponto de entrada do provedor com base no protótipo WIZARDENTRY . Durante a configuração interativa, cada evento de usuário nas páginas de propriedades faz com que o Assistente de Perfil chame a função de retorno de chamada do provedor com base no protótipo SERVICEWIZARDDLGPROC .
Se um provedor de serviços que está sendo adicionado ao perfil for compatível com as páginas assistente de perfil, ele deverá permitir a configuração programática do perfil.