IADsProperty-Schnittstelle (iads.h)
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
- Binden An das Schemaklassenobjekt des ADSI-Objekts.
- 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.
- Binden Sie an den Schemacontainer des Schemaklassenobjekts, das Sie im ersten Schritt abgerufen haben.
- Rufen Sie das Attributdefinitionsobjekt der relevanten Eigenschaft aus dem Schemacontainer ab.
- 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 |