IADsProperty-Schnittstelle (iads.h)

  • Artikel

Die IADsProperty-Schnittstelle dient zum Verwalten einer einzelnen Attributdefinition für ein Schemaklassenobjekt. Eine Attributdefinition gibt die minimalen und maximalen Werte einer Eigenschaft, deren Syntax und an, ob die Eigenschaft mehrere Werte unterstützt. Weitere Schnittstellen, die an der Schemaverwaltung beteiligt sind , sind IADsClass und IADsSyntax.

Die IADsProperty-Schnittstelle macht Methoden verfügbar, um eine Eigenschaft nach Name, Syntax, Wertbereichen und anderen definierten Attributen zu beschreiben. Einer Eigenschaft können mehrere Namen zugeordnet sein, aber Anbieter müssen sicherstellen, dass jeder Name eindeutig ist.

Verwenden Sie die IADsProperty-Schnittstelle , um zur Laufzeit die Attributdefinition einer Eigenschaft zu bestimmen, die von einem Verzeichnisdienstobjekt unterstützt wird.

So bestimmen Sie die Attributdefinition zur Laufzeit

  1. Binden An das Schemaklassenobjekt des ADSI-Objekts.
  2. Auflisten obligatorischer oder optionaler Attribute, auf die über das Schemaklassenobjekt zugegriffen werden kann. Überspringen Sie diesen Schritt, wenn Sie wissen, dass das Objekt das von Ihnen gewünschte Attribut unterstützt.
  3. Binden Sie an den Schemacontainer des Schemaklassenobjekts, das Sie im ersten Schritt abgerufen haben.
  4. Rufen Sie das Attributdefinitionsobjekt der relevanten Eigenschaft aus dem Schemacontainer ab.
  5. Untersuchen Sie die Attributdefinition der Eigenschaft. Möglicherweise müssen Sie auch das Syntaxobjekt untersuchen.

Vererbung

Die IADsProperty-Schnittstelle erbt von IDispatch und IADs. IADsProperty verfügt auch über folgende Membertypen:

Methoden

Die IADsProperty-Schnittstelle verfügt über diese Methoden.

 
IADsProperty::Qualifizierer

Gibt eine Auflistung von ADSI-Objekten zurück, die zusätzliche Qualifizierer dieser Eigenschaft beschreiben.

Hinweise

Die Methoden der IADsProperty-Schnittstelle können einer anbieterspezifischen Implementierung neue Attribute und Eigenschaftsobjekte hinzufügen.

Beispiele

Im folgenden Codebeispiel wird das obige Verfahren zum Anwenden der IADsProperty-Schnittstelle zum Bestimmen von Attributdefinitionen einer Eigenschaft veranschaulicht.

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

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile iads.h

Weitere Informationen

Iads

IADs-Klasse

IDispatch