IProfAdmin::SetDefaultProfile

Aplica-se a: Outlook 2013 | Outlook 2016

Define ou limpa o perfil padrão de um cliente.

HRESULT SetDefaultProfile(
  LPSTR lpszProfileName,
  ULONG ulFlags
);

Parâmetros

lpszProfileName

[em] Um ponteiro para o nome do perfil que se tornará o padrão ou NULL. Definir lpszProfileName como NULL indica que SetDefaultProfile deve remover o perfil padrão existente, deixando o cliente sem um padrão.

ulFlags

[em] Uma máscara de bits de sinalizadores que controla o tipo da cadeia de caracteres apontada por lpszProfileName. O seguinte sinalizador pode ser definido:

MAPI_UNICODE

O nome do perfil está no formato Unicode. Se o sinalizador de MAPI_UNICODE não estiver definido, o nome do perfil estará no formato ANSI.

Valor de retorno

S_OK

Um perfil padrão foi estabelecido ou removido com êxito.

E_FAIL

O perfil especificado não pode ser definido como o perfil padrão.

MAPI_E_NOT_FOUND

O perfil especificado não existe.

Comentários

O método IProfAdmin::SetDefaultProfile estabelece um perfil específico como o perfil padrão do cliente ou limpa o perfil padrão atual. Um perfil de "aplicativo" não pode ser definido como o perfil padrão. O perfil padrão é aquele usado automaticamente sempre que o cliente inicia uma sessão MAPI. SetDefaultProfile também define a propriedade PR_DEFAULT_PROFILE (PidTagDefaultProfile) do novo perfil padrão como TRUE.

Notas para chamadores

Para iniciar uma sessão com o perfil padrão, passe o sinalizador MAPI_USE_DEFAULT para a função MAPILogonEx .

Confira também

IProfAdmin::GetProfileTable

MAPILogonEx

Propriedade canônica PidTagDefaultProfile

IProfAdmin : IUnknown