IMAPIStatus::SettingsDialog
Hace referencia a: Outlook 2013 | Outlook 2016
Muestra una hoja de propiedades que permite al usuario cambiar la configuración de un proveedor de servicios Este método no se admite en los objetos de estado que implementa MAPI.
HRESULT SettingsDialog(
ULONG_PTR ulUIParam,
ULONG ulFlags
);
Parameters
ulUIParam
[in] Identificador de la ventana primaria de la hoja de propiedades de configuración.
ulFlags
[in] Máscara de bits de marcas que controla la visualización de la hoja de propiedades. Se puede establecer la marca siguiente:
UI_READONLY
Sugiere que el proveedor no debe permitir que los usuarios cambien las propiedades de configuración. Esta marca es solo una sugerencia; se puede omitir.
Valor devuelto
S_OK
La hoja de propiedades de configuración se mostró correctamente.
MAPI_E_NO_SUPPORT
El objeto status no admite este método, como se indica en la ausencia de la marca de STATUS_SETTINGS_DIALOG en la propiedad PR_RESOURCE_METHODS (PidTagResourceMethods).
Comentarios
El método IMAPIStatus::SettingsDialog muestra una hoja de propiedades de configuración. Todos los proveedores de servicios deben admitir el método SettingsDialog , pero no es necesario. Los proveedores de servicios pueden implementar sus propias hojas de propiedades o usar la implementación proporcionada en el método IMAPISupport::D oConfigPropsheet del objeto de soporte técnico. DoConfigPropsheet crea una hoja de propiedades de lectura y escritura.
Notas a los implementadores
Si un proveedor de transporte remoto tiene alguna configuración, debe hacer lo siguiente:
Abra la sección perfil del proveedor de transporte.
Obtenga la configuración de propiedades del proveedor de transporte desde el perfil.
Mostrar la configuración de propiedades en un cuadro de diálogo.
Si el cuadro de diálogo permite editar la configuración de la propiedad, compruebe que la nueva configuración sea válida y guárdelas de nuevo en la sección de perfil del proveedor de transporte.
Devuelve S_OK o los valores de error devueltos durante los pasos anteriores.
Notas para los llamadores
Puede usar la hoja de propiedades que se muestra a través de SettingsDialog para realizar una variedad de tareas, como las siguientes:
Especifique un almacén de mensajes predeterminado.
Especifique un pedido de transporte.
Especifique un contenedor de libreta de direcciones predeterminado para examinarlo.
Especifique un orden de búsqueda para resolver nombres ambiguos.
Especifique una libreta de direcciones personal predeterminada.
Los proveedores de servicios pueden implementar hojas de propiedades de lectura y escritura, de solo lectura o de una combinación de permisos, en función de la propiedad . Los proveedores de servicios pueden implementar permisos diferentes en propiedades individuales estableciendo restricciones de propiedad. El modo predeterminado para las hojas de propiedades es de lectura y escritura. Puede solicitar hojas de propiedades de solo lectura si establece la marca de UI_READONLY en las llamadas a SettingsDialog. Los proveedores de servicios que pueden implementar hojas de propiedades de solo lectura pueden hacerlo. Sin embargo, dado que algunos proveedores de servicios no pueden invalidar el modo predeterminado, debe estar preparado para controlar las hojas de propiedades de cualquier tipo.
Dado que una interfaz de usuario siempre está implicada en esta operación, solo los clientes interactivos deben llamar a SettingsDialog.
Vea también
IMAPISupport::DoConfigPropsheet