IProfAdmin::AdminServices
Hace referencia a: Outlook 2013 | Outlook 2016
Proporciona acceso a un objeto de administración del servicio de mensajes para realizar cambios en los servicios de mensajes de un perfil.
HRESULT AdminServices(
LPSTR lpszProfileName,
LPSTR lpszPassword,
ULONG_PTR ulUIParam,
ULONG ulFlags,
LPSERVICEADMIN FAR * lppServiceAdmin
);
Parameters
lpszProfileName
[in] Puntero al nombre del perfil que se va a modificar. El parámetro lpszProfileName no debe ser NULL.
lpszPassword
[in] Siempre NULL.
ulUIParam
[in] Identificador de la ventana primaria para los cuadros de diálogo o ventanas que muestra este método.
ulFlags
[in] Máscara de bits de marcas que controla la recuperación del objeto de administración del servicio de mensajes. Se pueden establecer las siguientes marcas:
MAPI_DIALOG
Habilita la presentación de una interfaz de usuario.
MAPI_UNICODE
El nombre del perfil está en formato Unicode. Si no se establece la marca MAPI_UNICODE, el nombre está en formato ANSI.
lppServiceAdmin
[out] Puntero a un puntero a un objeto de administración del servicio de mensajes.
Valor devuelto
S_OK
El objeto de administración del servicio de mensajes se devolvió correctamente.
MAPI_E_LOGON_FAILED
El perfil especificado no existe o la contraseña era incorrecta y no se pudo mostrar un cuadro de diálogo al usuario para solicitar la contraseña correcta porque MAPI_DIALOG no se estableció en ulFlags.
MAPI_E_USER_CANCEL
El usuario canceló la operación, normalmente haciendo clic en el botón Cancelar de un cuadro de diálogo.
Comentarios
El método IProfAdmin::AdminServices proporciona acceso a un objeto de administración del servicio de mensajes para realizar cambios de configuración en los servicios de mensajes de un perfil.
El parámetro lpszPassword debe ser NULL o un puntero a una cadena de longitud cero.
Notas para los llamadores
Aunque puede recuperar un puntero IMsgServiceAdmin llamando a este método o IMAPISession::AdminServices, llame a IProfAdmin::AdminServices si tiene estrictamente un cliente de configuración y no ofrece ninguna característica de mensajería. IProfAdmin::AdminServices no crea un objeto de sesión y no carga ningún proveedor de servicios, lo que mejora el rendimiento.
No puede usar IProfAdmin::AdminServices para crear un perfil. Por lo tanto, debe especificar un perfil válido existente en lpszProfileName. Si el perfil especificado no existe, IProfAdmin::AdminServices devuelve MAPI_E_LOGON_FAILED.
El nombre del perfil puede tener hasta 64 caracteres y puede incluir los siguientes caracteres:
Todos los caracteres alfanuméricos, incluidos los caracteres de énfasis y el carácter de subrayado.
Espacios incrustados, pero no espacios iniciales o finales.
Referencia de MFCMAPI
Para obtener un ejemplo de código de MFCMAPI, vea la siguiente tabla.
| Archivo | Función | Comment |
|---|---|---|
| MAPIProfileFunctions.cpp |
HrAddServiceToProfile |
MFCMAPI usa el método IProfAdmin::AdminServices para abrir un objeto de administración del servicio de mensajes para que el perfil seleccionado agregue servicios. |