Interfaz IADsProperty (iads.h)

Artículo
03/14/2023

La interfaz IADsProperty está diseñada para administrar una única definición de atributo para un objeto de clase de esquema. Una definición de atributo especifica los valores mínimo y máximo de una propiedad, su sintaxis y si la propiedad admite varios valores. Otras interfaces implicadas en la administración de esquemas incluyen IADsClass e IADsSyntax.

La interfaz IADsProperty expone métodos para describir una propiedad por nombre, sintaxis, intervalos de valores y cualquier otro atributo definido. Una propiedad puede tener varios nombres asociados, pero los proveedores deben asegurarse de que cada nombre sea único.

Use la interfaz IADsProperty para determinar en tiempo de ejecución la definición de atributo de una propiedad compatible con un objeto de servicio de directorio.

Para determinar la definición del atributo en tiempo de ejecución

Enlazar al objeto de clase de esquema del objeto ADSI.
Enumera los atributos obligatorios o opcionales a los que se puede acceder desde el objeto de clase de esquema. Omita este paso si sabe que el objeto admite el atributo de su interés.
Enlace al contenedor de esquemas del objeto de clase de esquema que obtuvo en el primer paso.
Recupere el objeto de definición de atributo de la propiedad de interés del contenedor de esquemas.
Examine la definición de atributo de la propiedad. Es posible que también tenga que inspeccionar el objeto de sintaxis.

Herencia

La interfaz IADsProperty hereda de IDispatch e IADs. IADsProperty también tiene estos tipos de miembros:

Métodos

La interfaz IADsProperty tiene estos métodos.


IADsProperty::Qualifiers Devuelve una colección de objetos ADSI que describen calificadores adicionales de esta propiedad.

Comentarios

Los métodos de interfaz IADsProperty pueden agregar nuevos atributos y objetos de propiedad a una implementación específica del proveedor.

Ejemplos

En el ejemplo de código siguiente se muestra el procedimiento anterior para aplicar la interfaz IADsProperty para determinar las definiciones de atributo de una propiedad.

Dim obj As IADs
Dim cl As IADsClass
Dim pr As IADsProperty
Dim sy As IADsSyntax
Dim sc As IADsContainer

On Error GoTo Cleanup
 
' Step 1
Set obj = GetObject("WinNT://myMachine,computer")
Set cl = GetObject(obj.Schema)
 
' Step 2
' Skip it, assuming the "Owner" attribute is supported by obj.
' For the computer object in this example, it is indeed one of 
' the supported optional properties.
 
' Step 3
Set sc = GetObject(cl.Parent)
 
' Step 4
Set pr = sc.GetObject("Property","Owner")
 
' Step 5
MsgBox "Attribute: " & pr.Name
MsgBox "Syntax:    " & pr.Syntax
If pr.Multivalued = True Then
    MsgBox "The Owner attribute has multiple values."
Else
    MsgBox "The Owner attribute has a single value."
End If
 
' To further examine the syntax
Set sy = GetObject(sc.AdsPath & "/" & pr.Syntax)
MsgBox "Syntax object: " & sy.Name & " of OleAutoDataType: " _
       & sy.OleAutoDataType

Cleanup:
    If (Err.Number <> 0 ) Then
        MsgBox("An error has occurred. " & Err.Number)
    End If

    Set obj = Nothing
    Set cl = Nothing
    Set pr = Nothing
    Set sy = Nothing
    Set sc = Nothing