IMAPIStatus::SettingsDialog
Aplica-se a: Outlook 2013 | Outlook 2016
Exibe uma folha de propriedades que permite que o usuário altere a configuração de um provedor de serviços Esse método não tem suporte em status objetos que o MAPI implementa.
HRESULT SettingsDialog(
ULONG_PTR ulUIParam,
ULONG ulFlags
);
Parâmetros
ulUIParam
[in] Um identificador para a janela pai da folha de propriedades de configuração.
ulFlags
[in] Um bitmask de sinalizadores que controla a exibição da folha de propriedades. O seguinte sinalizador pode ser definido:
UI_READONLY
Sugere que o provedor não deve permitir que os usuários alterem as propriedades de configuração. Esse sinalizador é apenas uma sugestão; ela pode ser ignorada.
Valor de retorno
S_OK
A folha de propriedades de configuração foi exibida com êxito.
MAPI_E_NO_SUPPORT
O objeto status não dá suporte a esse método, conforme indicado pela ausência do sinalizador de STATUS_SETTINGS_DIALOG na propriedade PR_RESOURCE_METHODS (PidTagResourceMethods).
Comentários
O método IMAPIStatus::SettingsDialog exibe uma folha de propriedades de configuração. Todos os provedores de serviços devem dar suporte ao método SettingsDialog , mas não é necessário. Os provedores de serviço podem implementar suas próprias planilhas de propriedades ou usar a implementação fornecida no método IMAPISupport::D oConfigPropsheet do objeto de suporte. O DoConfigPropsheet cria uma folha de propriedades de leitura/gravação.
Observações para implementadores
Se um provedor de transporte remoto tiver alguma configuração, ele deverá fazer o seguinte:
Abra a seção de perfil do provedor de transporte.
Obtenha as configurações de propriedade do provedor de transporte do perfil.
Exiba as configurações da propriedade em uma caixa de diálogo.
Se a caixa de diálogo permitir a edição das configurações da propriedade, marcar que as novas configurações sejam válidas e armazene-as novamente na seção de perfil do provedor de transporte.
Retornar S_OK ou quaisquer valores de erro retornados durante as etapas anteriores.
Notas para chamadores
Você pode usar a folha de propriedades exibida por meio do SettingsDialog para executar uma variedade de tarefas, como a seguinte:
Especifique um repositório de mensagens padrão.
Especifique uma ordem de transporte.
Especifique um contêiner de catálogo de endereços padrão para navegação.
Especifique uma ordem de pesquisa para resolver nomes ambíguos.
Especifique um catálogo de endereços pessoais padrão.
Os provedores de serviços podem implementar planilhas de propriedades que são leitura/gravação, somente leitura ou uma mistura de permissões, dependendo da propriedade. Os provedores de serviços podem implementar permissões diferentes em propriedades individuais definindo restrições de propriedade. O modo padrão para folhas de propriedades é leitura/gravação. Você pode solicitar planilhas de propriedades somente leitura definindo o sinalizador de UI_READONLY em suas chamadas para ConfiguraçõesDialog. Provedores de serviços capazes de implementar planilhas de propriedades somente leitura podem fazê-lo. No entanto, como alguns provedores de serviços não podem substituir o modo padrão, você deve estar preparado para lidar com planilhas de propriedades de qualquer tipo.
Como uma interface do usuário está sempre envolvida nessa operação, apenas clientes interativos devem chamar ConfiguraçõesDialog.
Confira também
IMAPISupport::DoConfigPropsheet