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 palavra-passe do novo perfil.
ulUIParam
[in] Uma alça para a janela principal de quaisquer caixas de diálogo ou janelas que este método apresente.
ulFlags
[in] Uma máscara de bits de sinalizadores que controla a forma como o perfil é criado. Os seguintes sinalizadores podem ser definidos:
MAPI_APP_PROFILE
A MAPI deve criar este perfil como um perfil de "aplicação", o que limita a deteção e as interações.
Este sinalizador pode não ser reconhecido ou suportado em todas as implementações mapi.
MAPI_DEFAULT_SERVICES
A MAPI deve preencher o novo perfil com os serviços de mensagens incluídos na secção [Serviços Predefinidos] do ficheiro Mapisvc.inf.
MAPI_DIALOG
As folhas de propriedades de configuração de cada um dos fornecedores nos serviços de mensagens a adicionar podem ser apresentadas.
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
Pode chamar CreateProfile no momento da instalação da aplicação ou em qualquer altura durante uma sessão. Quando este método é chamado no momento da instalação, muitas das definições de configuração provêm do ficheiro de configuração Mapisvc.inf. Quando este método é chamado durante uma sessão ativa, as definições são provenientes do utilizador que é solicitado através de uma série de folhas de propriedades.
Se o sinalizador MAPI_DEFAULT_SERVICES estiver definido no parâmetro ulFlags , CreateProfile chama a função de ponto de entrada do serviço de mensagens para cada serviço de mensagens na secção [Serviços Predefinidos] no ficheiro Mapisvc.inf. Cada função de ponto de entrada do serviço de mensagens é chamada com o parâmetro ulContext definido como MSG_SERVICE_CREATE.
Se os sinalizadores MAPI_DIALOG e MAPI_DEFAULT_SERVICES estiverem definidos, os valores nos parâmetros ulUIParam e ulFlags também são transmitidos para a função de ponto de entrada do serviço de mensagens. As funções de ponto de entrada do serviço de mensagens são chamadas apenas depois de todas as informações disponíveis do ficheiro Mapisvc.inf terem sido adicionadas ao perfil.
O nome do novo perfil e a respetiva palavra-passe podem ter até 64 carateres de comprimento e podem incluir os seguintes carateres:
Todos os carateres alfanuméricos, incluindo carateres de destaque e o caráter de sublinhado.
Espaços incorporados, mas não espaços à esquerda ou à direita.
O parâmetro lpszPassword tem de ser NULL ou um ponteiro para uma cadeia de comprimento zero.
Confira também
IMsgServiceAdmin::ConfigureMsgService