IProviderAdmin::DeleteProvider
Aplica-se a: Outlook 2013 | Outlook 2016
Exclui um provedor de serviços do serviço de mensagem.
HRESULT DeleteProvider(
LPMAPIUID lpUID
);
Parâmetros
lpUID
[in, out] Um ponteiro para a estrutura MAPIUID que contém o identificador exclusivo que representa o provedor a ser excluído.
Valor de retorno
S_OK
O provedor foi excluído com êxito do serviço de mensagem.
MAPI_E_NOT_FOUND
O MAPIUID apontado pelo parâmetro lpUID não foi reconhecido.
Comentários
O método IProviderAdmin::D eleteProvider exclui um provedor de serviços do serviço de mensagem. DeleteProvider determina que o provedor de serviços exclua correspondendo à estrutura MAPIUID apontada por lpUID com o conjunto de identificadores registrados pelos provedores de serviços ativos.
A maioria dos serviços de mensagem não permite que provedores sejam excluídos enquanto o perfil estiver em uso. Se o provedor a ser excluído estiver em uso, DeleteProvider o marcará para exclusão em vez de removê-lo imediatamente e retornará S_OK. Quando o provedor não está mais sendo usado, ele é excluído.
DeleteProvider chama a função de ponto de entrada do serviço de mensagem antes que o provedor seja removido do serviço. O parâmetro ulContext é definido como MSG_SERVICE_PROVIDER_DELETE. A função de ponto de entrada do serviço de mensagem executa as seguintes tarefas:
Exclui o provedor de serviços.
Exclui a seção de perfil do provedor de serviços.
A função de ponto de entrada do serviço de mensagem não é chamada novamente após a exclusão do provedor.