Acessando o cache de propriedades com interfaces IADsProperty

As interfaces IADsProperty consistem em IADsPropertyList, IADsPropertyEntry e IADsPropertyValue. Essas interfaces fornecem métodos para acessar e manipular diretamente as propriedades de um cache de objetos. Uma propriedade é conhecida como uma entrada de propriedade e corresponde a um atributo definido no esquema. Uma entrada de propriedade pode ter um ou vários valores de propriedade. Um conjunto de entradas de propriedade é organizado como uma lista de propriedades.

A interface IADsPropertyList gerencia a lista de propriedades de um objeto ADSI. A interface IADsPropertyEntry executa essa operação para uma entrada de propriedade. Da mesma forma, a interface IADsPropertyValue representa um ou mais valores de propriedade. Juntos, eles fornecem um mecanismo para que os usuários:

• Trabalhe diretamente com o cache de propriedades.
• Trabalhe com diretórios que não contêm esquemas, como um servidor LDAP versão 2.

As interfaces IADsProperty* operam estritamente no cache de propriedades e não fazem nenhuma tentativa de cooperar com o servidor para recuperar ou modificar os dados no armazenamento persistente. Como tal, essas interfaces são usadas apenas para examinar e manipular propriedades no cache do cliente. Antes de usar essas interfaces, você deve chamar o método IADs::GetInfo ou o método IADs::GetInfoEx explicitamente para carregar as propriedades do objeto no cache, se o cache não tiver sido inicializado. Depois de chamar os métodos dessas interfaces, você deve chamar IADs::SetInfo para persistir as alterações no armazenamento de diretório subjacente.

Para obter mais informações e um exemplo de código que pode ser usado para implementar essas interfaces, consulte Código de exemplo para usar interfaces IADsProperty para acessar o cache de propriedades.