Leer en inglés

Compartir a través de


IProfAdmin::DeleteProfile

Hace referencia a: Outlook 2013 | Outlook 2016

Elimina un perfil.

HRESULT DeleteProfile(
  LPSTR lpszProfileName,
  ULONG ulFlags
);

Parameters

lpszProfileName

[in] Puntero al nombre del perfil que se va a eliminar.

ulFlags

[in] Máscara de bits de marcas que controla cómo se elimina un perfil. Se puede establecer la marca siguiente:

MAPI_APP_PROFILE

Permite eliminar un perfil de "aplicación". Esta marca debe establecerse si el perfil que se va a eliminar es un perfil de "aplicación".

Es posible que esta marca no se reconozca o no se admita en todas las implementaciones MAPI.

Valor devuelto

S_OK

El perfil se eliminó correctamente.

MAPI_E_NO_ACCESS

El perfil es un perfil de "aplicación" y no se ha establecido la marca de MAPI_APP_PROFILE.

MAPI_E_NOT_FOUND

El perfil especificado no existe.

Comentarios

El método IProfAdmin::D eleteProfile elimina un perfil. Si el perfil que se va a eliminar está en uso cuando se llama a DeleteProfile , DeleteProfile devuelve S_OK pero no elimina el perfil inmediatamente. En su lugar, DeleteProfile marca el perfil para su eliminación y lo elimina una vez que ya no se usa, cuando todas sus sesiones activas han finalizado.

Se llama a la función de punto de entrada para cada servicio de mensajes del perfil con el valor MSG_SERVICE_DELETE establecido en el parámetro ulContext . En primer lugar, la función elimina el servicio y, a continuación, elimina la sección de perfil del servicio. No se vuelve a llamar a la función de punto de entrada del servicio de mensajes después de eliminar el servicio.

No se requiere ninguna contraseña para eliminar un perfil.

Referencia de MFCMAPI

Para obtener un ejemplo de código de MFCMAPI, vea la siguiente tabla.

Archivo Función Comment
MAPIProfileFunctions.cpp
HrRemoveProfile
MFCMAPI usa el método IProfAdmin::D eleteProfile para eliminar el perfil seleccionado.

Recursos adicionales

IMsgServiceAdmin::DeleteMsgService

MSGSERVICEENTRY

IProfAdmin : IUnknown

MFCMAPI como un ejemplo de c�digo