IMsgServiceAdmin::DeleteMsgService
Aplica-se a: Outlook 2013 | Outlook 2016
Exclui um serviço de mensagem de um perfil.
HRESULT DeleteMsgService(
LPMAPIUID lpuid
);
Parâmetros
lpuid
[in] Um ponteiro para a estrutura MAPIUID que contém o identificador exclusivo para o serviço de mensagem excluir.
Valor de retorno
S_OK
O serviço de mensagem foi excluído.
MAPI_E_NOT_FOUND
O MAPIUID apontado por lpuid não corresponde a um serviço de mensagem existente.
Comentários
O método IMsgServiceAdmin::D eleteMsgService exclui um serviço de mensagem de um perfil. DeleteMsgService remove todas as seções de perfil relacionadas ao serviço de mensagem.
DeleteMsgService executa as seguintes etapas para excluir o serviço de mensagem:
Chama a função de ponto de entrada do serviço de mensagem com o parâmetro ulContext definido como MSG_SERVICE_DELETE antes que as seções de perfil sejam removidas. Isso permite que o serviço execute tarefas específicas do serviço.
Exclui o serviço de mensagem.
Exclui a seção de perfil do serviço de mensagem.
A função de ponto de entrada do serviço de mensagem não é chamada novamente após a exclusão do serviço.
Notas para chamadores
Para recuperar a estrutura MAPIUID para que o serviço de mensagem seja excluído, recupere a coluna de propriedade PR_SERVICE_UID (PidTagServiceUid) da linha do serviço de mensagem na tabela de serviço de mensagem. Para obter mais informações, consulte o procedimento descrito no método IMsgServiceAdmin::CreateMsgService .
Referência do MFCMAPI
Para ver códigos de exemplo do MFCMAPI, confira a tabela a seguir.
| Arquivo | Função | Comentário |
|---|---|---|
| MsgServiceTableDlg.cpp |
CMsgServiceTableDlg::OnDeleteSelectedItem |
O MFCMAPI usa o método IMsgServiceAdmin::D eleteMsgService para excluir o serviço selecionado. |