IProfAdmin::DeleteProfile

Aplica-se a: Outlook 2013 | Outlook 2016

Exclui um perfil.

HRESULT DeleteProfile(
  LPSTR lpszProfileName,
  ULONG ulFlags
);

Parâmetros

lpszProfileName

[em] Um ponteiro para o nome do perfil a ser excluído.

ulFlags

[em] Uma máscara de bits de sinalizadores que controla como um perfil é excluído. O seguinte sinalizador pode ser definido:

MAPI_APP_PROFILE

Permite a exclusão de um perfil de "aplicativo". Esse sinalizador deverá ser definido se o perfil a ser excluído for um perfil de "aplicativo".

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

Valor de retorno

S_OK

O perfil foi excluído com sucesso.

MAPI_E_NO_ACCESS

O perfil é um perfil de "aplicativo" e o sinalizador de MAPI_APP_PROFILE não foi definido.

MAPI_E_NOT_FOUND

O perfil especificado não existe.

Comentários

O método IProfAdmin::D eleteProfile exclui um perfil. Se o perfil a ser excluído estiver em uso quando DeleteProfile for chamado, DeleteProfile retornará S_OK, mas não excluirá o perfil imediatamente. Em vez disso, DeleteProfile marca o perfil para exclusão e o exclui depois que ele não está mais sendo usado, quando todas as suas sessões ativas terminarem.

A função de ponto de entrada para cada serviço de mensagens no perfil é chamada com o valor MSG_SERVICE_DELETE definido no parâmetro ulContext . Primeiro, a função exclui o serviço e, em seguida, exclui a seção de perfil do serviço. A função de ponto de entrada do serviço de mensagens não é chamada novamente após o serviço ter sido excluído.

Nenhuma senha é necessária para excluir um perfil.

Referência do MFCMAPI

Para ver códigos de exemplo do MFCMAPI, confira a tabela a seguir.

Confira também

IMsgServiceAdmin::DeleteMsgService

MSGSERVICEENTRY

IProfAdmin : IUnknown

MFCMAPI como exemplo de código