IProfSect : IMAPIProp

Aplica-se a: Outlook 2013 | Outlook 2016

Funciona com as propriedades dos objetos da seção de perfil.

Vtable order

Essa interface não tem métodos exclusivos.

Notas para chamadores

A interface IProfSect não tem métodos exclusivos, mas você pode chamar os métodos IMAPIProp da seção de perfil. Há algumas diferenças entre a implementação do IProfSect e outras implementações do IMAPIProp:

• O IProfSect não dá suporte a um modelo de transação.

• O IProfSect não dá suporte a propriedades nomeadas.

• O IProfSect reserva o intervalo de identificador 0x67F0 para 0x67ff para propriedades seguras.

Não dar suporte a um modelo de transação significa que todas as alterações feitas em uma seção de perfil após chamadas para os métodos IMAPIProp::CopyProps e IMAPIProp::CopyTo ocorrem imediatamente. As chamadas para o método IMAPIProp::SaveChanges têm êxito, mas não salvam nenhuma alteração.

Para serem protegidos contra alterações que ocorrem prematuramente, os provedores de serviços precisam fazer cópias de suas seções de perfil exibidas aos usuários por meio de planilhas de propriedades. As planilhas de propriedades devem funcionar com a cópia, em vez da seção de perfil real. Quando o usuário clica no botão OK para verificar se as alterações são precisas, as alterações podem ser salvas na seção perfil real.

Para implementar uma folha de propriedades usando uma seção de perfil copiado, use o seguinte procedimento:

1. Abra a seção perfil chamando o método IMAPISupport::OpenProfileSection ou IProviderAdmin::OpenProfileSection .

2. Chame a função CreateIProp para recuperar um objeto de dados de propriedade – um objeto que dá suporte à interface IPropData .

3. Chame o método IMAPIProp::CopyTo da seção de perfil para copiar as propriedades que serão exibidas na folha de propriedades da seção de perfil para o objeto de dados da propriedade.

4. Chame o método IMAPISupport::D oConfigPropSheet para solicitar que o provedor de serviço exiba uma folha de propriedades e passe um ponteiro para o objeto de dados de propriedade no parâmetro lpConfigData .

5. Quando o usuário salvar alterações nas propriedades de configuração na folha de propriedades, chame o método IMAPIProp::CopyTo para copiar as propriedades do objeto de dados de propriedade de volta para a seção de perfil.

Seções de perfil, ao contrário de outros objetos, não dão suporte a propriedades nomeadas. Os métodos IMAPIProp::GetIDsFromNames e IMAPIProp::GetNamesFromIDs retornam MAPI_E_NO_SUPPORT se forem chamados em um objeto de seção de perfil. Se você usar o método IMAPIProp::SetProps para definir identificadores de propriedade no intervalo acima 0x8000, o tipo de propriedade PT_ERROR será retornado.

As seções de perfil reservam o intervalo de identificador 0x67F0 para 0x67FF para propriedades seguras. Os provedores de serviços podem usar esse intervalo para armazenar senhas e outras credenciais específicas do provedor. As propriedades nesse intervalo não são retornadas na lista completa de propriedades quando NULL é passada no parâmetro lpPropTag do método IMAPIProp::GetProps , nem são retornadas no parâmetro lppPropTagArray do método IMAPIProp::GetPropList . As propriedades seguras devem ser solicitadas especificamente por seus identificadores.

O MAPI fornece uma seção de perfil com a MUID_PROFILE_INSTANCE constante codificada como seu identificador e PR_SEARCH_KEY (PidTagSearchKey) como sua propriedade única. O MAPI garante que o valor da propriedade PR_SEARCH_KEY será exclusivo entre todos os perfis criados. Use PR_SEARCH_KEY em vez de PR_PROFILE_NAME quando a exclusividade for importante, pois é possível que um perfil excluído seja seguido por outro perfil com o mesmo nome.

Para obter mais informações sobre como usar seções de perfil, consulte Administrando perfis e serviços de mensagens.

Confira também

Interfaces MAPI