IProfAdmin::SetDefaultProfile
Aplica-se a: Outlook 2013 | Outlook 2016
Define ou limpa o perfil predefinido de um cliente.
HRESULT SetDefaultProfile(
LPSTR lpszProfileName,
ULONG ulFlags
);
Parâmetros
lpszProfileName
[in] Um ponteiro para o nome do perfil que se tornará a predefinição ou NULO. Definir lpszProfileName como NULL indica que SetDefaultProfile deve remover o perfil predefinido existente, deixando o cliente sem predefinição.
ulFlags
[in] Uma máscara de bits de sinalizadores que controla o tipo de cadeia apontado por lpszProfileName. Pode definir o seguinte sinalizador:
MAPI_UNICODE
O nome do perfil está no formato Unicode. Se o sinalizador MAPI_UNICODE não estiver definido, o nome do perfil estará no formato ANSI.
Valor de retorno
S_OK
Um perfil predefinido foi estabelecido ou removido com êxito.
E_FAIL
O perfil especificado não pode ser definido como o perfil predefinido.
MAPI_E_NOT_FOUND
O perfil especificado não existe.
Comentários
O método IProfAdmin::SetDefaultProfile estabelece um perfil específico como perfil predefinido do cliente ou limpa o perfil predefinido atual. Não é possível definir um perfil de "aplicação" como o perfil predefinido. O perfil predefinido é o perfil que é utilizado automaticamente sempre que o cliente inicia uma sessão MAPI. SetDefaultProfile também define a propriedade PR_DEFAULT_PROFILE (PidTagDefaultProfile) do novo perfil predefinido como VERDADEIRO.
Notas para chamadores
Para iniciar uma sessão com o perfil predefinido, transmita o sinalizador MAPI_USE_DEFAULT para a função MAPILogonEx .