Interface IADsProperty (iads.h)

Article
08/24/2023

L’interface IADsProperty est conçue pour gérer une définition d’attribut unique pour un objet de classe de schéma. Une définition d’attribut spécifie les valeurs minimales et maximales d’une propriété, sa syntaxe et si la propriété prend en charge plusieurs valeurs. Les autres interfaces impliquées dans la gestion des schémas incluent IADsClass et IADsSyntax.

L’interface IADsProperty expose des méthodes pour décrire une propriété par nom, syntaxe, plages de valeurs et tout autre attribut défini. Une propriété peut avoir plusieurs noms associés, mais les fournisseurs doivent s’assurer que chaque nom est unique.

Utilisez l’interface IADsProperty pour déterminer au moment de l’exécution la définition d’attribut d’une propriété prise en charge par un objet de service d’annuaire.

Pour déterminer la définition d’attribut au moment de l’exécution

Liez à l’objet de classe de schéma de l’objet ADSI.
Énumérez les attributs obligatoires ou facultatifs accessibles à partir de l’objet de classe de schéma. Ignorez cette étape si vous savez que l’objet prend en charge l’attribut qui vous intéresse.
Liez au conteneur de schémas de l’objet de classe de schéma que vous avez obtenu à la première étape.
Récupérez l’objet de définition d’attribut de la propriété d’intérêt à partir du conteneur de schémas.
Examinez la définition d’attribut de la propriété . Vous devrez peut-être également inspecter l’objet syntaxique.

Héritage

L’interface IADsProperty hérite d’IDispatch et d’IAD. IADsProperty a également les types de membres suivants :

Méthodes

L’interface IADsProperty a ces méthodes.


IADsProperty::Qualifiers Retourne une collection d’objets ADSI qui décrivent des qualificateurs supplémentaires de cette propriété.

Notes

Les méthodes d’interface IADsProperty peuvent ajouter de nouveaux attributs et objets de propriété à une implémentation spécifique au fournisseur.

Exemples

L’exemple de code suivant illustre la procédure ci-dessus pour appliquer l’interface IADsProperty pour déterminer les définitions d’attributs d’une propriété.

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