Compartilhar via


Criar um perfil usando código personalizado

Aplica-se a: Outlook 2013 | Outlook 2016

Se você optar por escrever código para criar um perfil, verifique se você entende como solicitar entradas de perfil e o tipo e a quantidade de informações necessárias para cada entrada. As implicações de ordenação de entradas em um perfil são explicadas em Perfis MAPI.

Para criar um perfil com código C ou C++

  1. Leia o arquivo de cabeçalho de cada serviço de mensagem. Entenda quais propriedades você precisará configurar e quais valores você usará.

  2. Chame a função MAPIAdminProfiles para recuperar um ponteiro de interface IProfAdmin .

  3. Chame IProfAdmin::CreateProfile para criar seu perfil. Se você quiser criar um perfil com os serviços de mensagem listados na seção [Serviços Padrão] do MAPISVC. Arquivo INF, defina o sinalizador MAPI_DEFAULT_SERVICE. Se você quiser permitir que o usuário insira informações de configuração, defina o sinalizador MAPI_DIALOG. Certifique-se de definir esse sinalizador se nem todas as informações necessárias estiverem disponíveis por meio do MAPISVC. Arquivo INF. CreateProfile chama a função de ponto de entrada para que cada serviço de mensagem seja adicionado ao perfil com MSG_SERVICE_CREATE definido como o parâmetro ulContext .

  4. Chame IProfAdmin::AdminServices para obter um objeto de administração do serviço de mensagem.

  5. Use o objeto de administração do serviço de mensagem para adicionar serviços de mensagem ao perfil. Para cada serviço de mensagem que você deseja adicionar:

  6. Chame o método IMsgServiceAdmin::CreateMsgService para criar o novo serviço de mensagem.

  7. Chame IMsgServiceAdmin::ConfigureMsgService, passando a estrutura MAPIUID do serviço que você acabou de criar e uma matriz de valor de propriedade com suas propriedades de configuração.

  8. Para recuperar o identificador de um serviço recém-adicionado, que é sua propriedade PR_SERVICE_UID (PidTagServiceUid), chame IMsgServiceAdmin::GetMsgServiceTable para acessar a tabela do serviço de mensagem e pesquisar a linha que representa o serviço de mensagem. A última linha na tabela representará o serviço de mensagem adicionado mais recentemente.

Para tornar um novo perfil temporário, chame o método IProfAdmin::D eleteProfile imediatamente após fazer logon. DeleteProfile marcará o novo perfil como excluído, tornando-o utilizável durante a sessão. Como ela não será incluída na tabela de perfil da sessão, outros clientes não poderão usá-la.