WIZARDENTRY

Aplica-se a: Outlook 2013 | Outlook 2016

Define uma função de ponto de entrada do provedor de serviços que o Assistente de Perfil chama para recuperar informações suficientes para exibir as planilhas de propriedades de configuração do provedor.

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

ULONG WIZARDENTRY(
  HINSTANCE hProviderDLLInstance,
  LPSTR FAR * lpcsResourceName,
  DLGPROC FAR * lppDlgProc,
  LPMAPIPROP lpMAPIProp,
  LPMAPISUPPORTOBJECT lpMapiSupportObject
);

Parâmetros

hProviderDLLInstance

[in] Identificador de instância da DLL do provedor de serviços.

lpcsResourceName

[out] Ponteiro para uma cadeia de caracteres que contém o nome completo do recurso de caixa de diálogo que deve ser exibido pelo Assistente de Perfil durante a configuração. O tamanho máximo da cadeia de caracteres, incluindo o terminador NULL, é de 32 caracteres.

lppDlgProc

[out] Ponteiro para um procedimento de caixa de diálogo padrão do Windows que será chamado pelo Assistente de Perfil para notificar o provedor de vários eventos.

lpMAPIProp

[in] Ponteiro para uma implementação de interface de propriedade que fornece acesso às propriedades de configuração.

lpMapiSupportObject

[in] Ponteiro para o objeto de suporte MAPI aplicável a esta sessão.

Valor de retorno

S_OK

A função WIZARDENTRY do provedor de serviços foi chamada com êxito.

MAPI_E_CALL_FAILED

Um erro de origem inesperada ou desconhecida impediu a conclusão da operação.

Comentários

O Assistente de Perfil chama a função baseada em WIZARDENTRY quando está pronta para exibir a interface do usuário de configuração do provedor de serviços. Quando o Assistente de Perfil terminar de configurar todos os provedores, ele grava as propriedades de configuração no perfil chamando IMsgServiceAdmin::ConfigureMsgService.

Observações para implementadores

O nome da função baseada em WIZARDENTRY deve ser colocado na entrada WIZARD_ENTRY_NAME em MAPISVC.INF.

O nome do recurso é o do recurso de caixa de diálogo que será renderizado no painel do Assistente de Perfil. O recurso que é passado de volta precisa conter todas as páginas em um único recurso de caixa de diálogo. Quando o Assistente de Perfil recebe esse recurso, ele ignora o estilo de diálogo, mas não os estilos de controle e cria todos os controles como filhos da página Assistente de Perfil. Todos os controles estão inicialmente ocultos. Os provedores devem garantir que as coordenadas para seus controles sejam baseadas em zero ou zero e que não excedam uma largura máxima de 200 unidades de diálogo e uma altura máxima de 150 unidades de diálogo. Os identificadores de controle abaixo de 400 são reservados para o Assistente de Perfil. O Assistente de Perfil exibe o título do provedor em texto em negrito acima da interface do usuário do provedor.

O ponteiro da interface da propriedade fornecido no parâmetro lpMAPIProp deve ser mantido pelo provedor para referência futura. O Assistente de Perfil lida apenas com o conjunto mais básico de propriedades e o provedor pode usar a implementação da interface da propriedade para incluir propriedades adicionais. Durante a configuração, os provedores devem adicionar suas propriedades de configuração ao objeto que implementa a interface da propriedade. Depois que todos os provedores tiverem sido configurados, o Assistente de Perfil adiciona essas propriedades ao perfil.

Para obter mais informações sobre como usar essa função, confira Suporte à Configuração do Serviço de Mensagem.