IProfAdmin::DeleteProfile
Hace referencia a: Outlook 2013 | Outlook 2016
Elimina un perfil.
HRESULT DeleteProfile(
LPSTR lpszProfileName,
ULONG ulFlags
);
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.
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.
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.
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. |