Compartir a través de


Acceso a la caché de propiedades con interfaces IADsProperty

Las interfaces IADsProperty constan de IADsPropertyList, IADsPropertyEntry e IADsPropertyValue. Estas interfaces proporcionan métodos para acceder directamente a las propiedades de una caché de objetos y manipularlas. Una propiedad se conoce como entrada de propiedad y corresponde a un atributo definido en el esquema. Una entrada de propiedad puede tener uno o varios valores de propiedad. Un conjunto de entradas de propiedad se organiza como una lista de propiedades.

La interfaz IADsPropertyList administra la lista de propiedades de un objeto ADSI. La interfaz IADsPropertyEntry realiza esta operación para una entrada de propiedad. Del mismo modo, la interfaz IADsPropertyValue representa uno o varios valores de propiedad. Juntos, proporcionan un mecanismo para que los usuarios:

  • Trabaje directamente con la memoria caché de propiedades.
  • Trabaje con directorios que no contengan esquemas, como un servidor LDAP versión 2.

Las interfaces IADsProperty* funcionan estrictamente en la memoria caché de propiedades y no realizan ningún intento de cooperar con el servidor para recuperar o modificar los datos en el almacén persistente. Por lo tanto, estas interfaces solo se usan para examinar y manipular propiedades en la memoria caché del cliente. Antes de usar estas interfaces, debe llamar al método IADs::GetInfo o al método IADs::GetInfoEx explícitamente para cargar las propiedades del objeto en la memoria caché, si la memoria caché no se ha inicializado. Después de llamar a los métodos de estas interfaces, debe llamar a IADs::SetInfo para conservar los cambios en el almacén de directorios subyacente.

Para obtener más información y un ejemplo de código que se puede usar para implementar estas interfaces, vea Código de ejemplo para usar interfaces IADsProperty para acceder a la memoria caché de propiedades.