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

[em] Um ponteiro para o nome do novo perfil.

lpszPassword

[em] Um ponteiro para a senha do novo perfil.

ulUIParam

[em] Um identificador para a janela pai de qualquer caixa de diálogo ou janela que esse método exiba.

ulFlags

[em] Uma máscara de bits de sinalizadores que controla como o perfil é criado. Os seguintes sinalizadores podem ser definidos:

MAPI_APP_PROFILE

O MAPI deve criar esse perfil como um perfil de "aplicativo", o que limita a descoberta e as interações.

Esse sinalizador pode não ser reconhecido ou não ter suporte em todas as implementações MAPI.

MAPI_DEFAULT_SERVICES

O MAPI deve preencher o novo perfil com os serviços de mensagens incluídos na seção [Serviços Padrão] do arquivo Mapisvc.inf.

MAPI_DIALOG

As folhas de propriedades de configuração de cada um dos provedores nos serviços de mensagens a serem incluídos 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 definições de configuração 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 solicitado por meio de uma série de folhas de propriedades.

Se o sinalizador MAPI_DEFAULT_SERVICES estiver definido no parâmetro ulFlags , o CreateProfile chamará a função de ponto de entrada do serviço de mensagens para cada serviço de mensagens na seção [Serviços Padrão] no arquivo 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 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 mensagens. As funções de ponto de entrada do serviço de mensagens são chamadas somente depois que todas as informações disponíveis do arquivo Mapisvc.inf tiverem sido adicionadas ao perfil.

O nome do novo perfil e sua senha podem ter até 64 caracteres e podem incluir os seguintes caracteres:

  • Todos os caracteres alfanuméricos, incluindo os caracteres de acento e o caractere de sublinhado.

  • Espaços incorporados, mas não espaços à direita ou à esquerda.

O parâmetro lpszPassword deve ser NULL ou um ponteiro para uma cadeia de comprimento zero.

Confira também

IMsgServiceAdmin::ConfigureMsgService

IMsgServiceAdmin::CreateMsgService

MSGSERVICEENTRY

IProfAdmin : IUnknown

  • Last updated on