IProfAdmin::DeleteProfile
Aplica-se a: Outlook 2013 | Outlook 2016
Elimina um perfil.
HRESULT DeleteProfile(
LPSTR lpszProfileName,
ULONG ulFlags
);
Parâmetros
lpszProfileName
[in] Um ponteiro para o nome do perfil a ser eliminado.
ulFlags
[in] Uma máscara de bits de sinalizadores que controla a forma como um perfil é eliminado. Pode definir o seguinte sinalizador:
MAPI_APP_PROFILE
Permite eliminar um perfil de "aplicação". Este sinalizador tem de ser definido se o perfil a eliminar for um perfil de "aplicação".
Este sinalizador pode não ser reconhecido ou suportado em todas as implementações mapi.
Valor de retorno
S_OK
O perfil foi eliminado com êxito.
MAPI_E_NO_ACCESS
O perfil é um perfil de "aplicação" e o sinalizador 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 elimina um perfil. Se o perfil a eliminar estiver a ser utilizado quando DeleteProfile é chamado, DeleteProfile devolve S_OK mas não elimina imediatamente o perfil. Em vez disso, DeleteProfile marca o perfil para eliminação e elimina-o depois de deixar de ser utilizado, quando todas as 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 elimina o serviço e, em seguida, elimina a secção de perfil do serviço. A função de ponto de entrada do serviço de mensagens não é chamada novamente depois de o serviço ter sido eliminado.
Não é necessária nenhuma palavra-passe para eliminar 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 utiliza o método IProfAdmin::D eleteProfile para eliminar o perfil selecionado. |