IADsPropertyEntry

The IADsPropertyEntry interface is used to manage a property entry in the property cache. A property entry holds a value (or values) of an attribute as defined in the schema. It is identified by the name of the corresponding attribute. A property entry object allows a user to specify how its values are to be manipulated. Examples of such operations include "update", "modify", and "delete".

Multiple property entries are managed by a property list. To access a property entry, you call the IADsPropertyList::Item or IADsPropertyList::GetPropertyItem method.

Before calling methods of this interface, you need to call IADs::GetInfo or IADs::GetInfoEx explicitly to load the assigned property values of the object into the cache. After calling the methods of this interface, call IADs::SetInfo to save the changes to the directory.

Inheritance: IDispatch

Methods

  • Method

  • Description

  • Clear

  • Clears all properties of the property entry object.

Properties

  • Property

  • Description

  • ADsType

  • Gets or sets the ADS data type of the property entry.

  • ControlCode

  • Gets or sets a value indicating the operation to be performed on the named property.

  • Name

  • Gets or sets the name of the property entry.

  • Values

  • Gets or sets an object[] array. Each element in this array represents a value of the named property.

Details

Clear

Clears all properties of the property entry object.

void Clear()

Remarks

The value of ADsType becomes ADSTYPE_INVALID and the value of ControlCode becomes ADS_PROPERTY_NONE. The Values and the Name properties are cleared.


ADsType

Gets or sets the ADS data type of the property entry. The values of the data type are defined in the ADSTYPEENUM enumeration.

  • Type:
  • int
  • Access:
  • Read/Write

ControlCode

Gets or sets a value indicating the operation to be performed on the named property. The constant values are specified in the ADS_PROPERTY_OPERATION_ENUM enumeration.

  • Type:
  • int
  • Access:
  • Read/Write

Name

Gets or sets the name of the property entry. This name should correspond to the name of an attribute as defined in the schema.

  • Type:
  • string
  • Access:
  • Read/Write

Values

Gets or sets an object[] array. Each element in this array represents a value of the named property. Such property values are represented by objects implementing the IADsPropertyValue and IADsPropertyValue2 interfaces.

  • Type:
  • Object
  • Access:
  • Read/Write

Requirements

Minimum required version: 2009.1

See also