IProfAdmin::DeleteProfile
Aplica-se a: Outlook 2013 | Outlook 2016
Exclui um perfil.
HRESULT DeleteProfile(
LPSTR lpszProfileName,
ULONG ulFlags
);
Parâmetros
Lpszprofilename
[in] Um ponteiro para o nome do perfil a ser excluído.
ulFlags
[in] Sempre NULL.
Valor de retorno
S_OK
O perfil foi excluído com êxito.
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 foram encerradas.
A função de ponto de entrada para cada serviço de mensagem 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 mensagem não é chamada novamente após a exclusão do serviço.
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.
| Arquivo | Função | Comentário |
|---|---|---|
| MAPIProfileFunctions.cpp |
HrRemoveProfile |
O MFCMAPI usa o método IProfAdmin::D eleteProfile para excluir o perfil selecionado. |