IProfAdmin::CreateProfile
Aplica-se a: Outlook 2013 | Outlook 2016
Cria um novo perfil.
HRESULT CreateProfile(
LPSTR lpszProfileName,
LPSTR lpszPassword,
ULONG_PTR ulUIParam,
ULONG ulFlags
);
Parâmetros
Lpszprofilename
[in] Um ponteiro para o nome do novo perfil.
lpszPassword
[in] Um ponteiro para a senha do novo perfil.
ulUIParam
[in] Um identificador para a janela pai de qualquer caixa de diálogo ou janelas que este método exibe.
ulFlags
[in] Um bitmask de sinalizadores que controla como o perfil é criado. Os seguintes sinalizadores podem ser definidos:
MAPI_DEFAULT_SERVICES
O MAPI deve preencher o novo perfil com os serviços de mensagem incluídos na seção [Serviços Padrão] do arquivo Mapisvc.inf.
MAPI_DIALOG
As planilhas de propriedades de configuração de cada um dos provedores nos serviços de mensagem a serem adicionados podem ser exibidas.
Valor de retorno
S_OK
O novo perfil foi criado.
MAPI_E_NO_ACCESS
O novo perfil especificado já existe.
Comentários
O método IProfAdmin::CreateProfile cria um novo perfil.
Notas para chamadores
Você pode chamar CreateProfile no momento da instalação do aplicativo ou a qualquer momento durante uma sessão. Quando esse método é chamado no momento da instalação, muitas das configurações vêm do arquivo de configuração Mapisvc.inf. Quando esse método é chamado durante uma sessão ativa, as configurações vêm do usuário que é solicitado por meio de uma série de planilhas de propriedades.
Se o sinalizador MAPI_DEFAULT_SERVICES for definido no parâmetro ulFlags , CreateProfile chamará a função de ponto de entrada do serviço de mensagem para cada serviço de mensagem na seção [Serviços Padrão] no arquivo Mapisvc.inf. Cada função de ponto de entrada do serviço de mensagem é chamada com o parâmetro ulContext definido como MSG_SERVICE_CREATE.
Se os sinalizadores MAPI_DIALOG e MAPI_DEFAULT_SERVICES forem definidos, os valores nos parâmetros ulUIParam e ulFlags também serão passados para a função de ponto de entrada do serviço de mensagem. As funções de ponto de entrada do serviço de mensagem são chamadas somente depois que todas as informações disponíveis do arquivo Mapisvc.inf foram adicionadas ao perfil.
O nome do novo perfil e sua senha podem ter até 64 caracteres de comprimento e podem incluir os seguintes caracteres:
Todos os caracteres alfanuméricos, incluindo caracteres de ênfase e o caractere sublinhado.
Espaços inseridos, mas não espaços à frente ou à direita.
O parâmetro lpszPassword deve ser NULL ou um ponteiro para uma cadeia de caracteres de comprimento zero.
Confira também
IMsgServiceAdmin::ConfigureMsgService