Interfaccia IADsProperty (iads.h)

Articolo
03/14/2023

L'interfaccia IADsProperty è progettata per gestire una singola definizione di attributo per un oggetto classe dello schema. Una definizione di attributo specifica i valori minimo e massimo di una proprietà, la relativa sintassi e se la proprietà supporta più valori. Altre interfacce coinvolte nella gestione dello schema includono IADsClass e IADsSyntax.

L'interfaccia IADsProperty espone metodi per descrivere una proprietà per nome, sintassi, intervalli di valori e qualsiasi altro attributo definito. A una proprietà possono essere associati più nomi, ma i provider devono assicurarsi che ogni nome sia univoco.

Usare l'interfaccia IADsProperty per determinare in fase di esecuzione la definizione dell'attributo di una proprietà supportata da un oggetto servizio directory.

Per determinare la definizione dell'attributo in fase di esecuzione

Eseguire l'associazione all'oggetto classe dello schema dell'oggetto ADSI.
Enumerare gli attributi obbligatori o facoltativi accessibili dall'oggetto classe dello schema. Ignorare questo passaggio se si sa che l'oggetto supporta l'attributo di interesse.
Eseguire l'associazione al contenitore dello schema dell'oggetto classe dello schema ottenuto nel primo passaggio.
Recuperare l'oggetto definizione dell'attributo della proprietà di interesse dal contenitore dello schema.
Esaminare la definizione dell'attributo della proprietà . Potrebbe essere necessario controllare anche l'oggetto sintassi.

Ereditarietà

L'interfaccia IADsProperty eredita da IDispatch e ID. IADsProperty include anche questi tipi di membri:

Metodi

L'interfaccia IADsProperty include questi metodi.


IADsProperty::Qualificatori Restituisce un insieme di oggetti ADSI che descrivono qualificatori aggiuntivi di questa proprietà.

Commenti

I metodi di interfaccia IADsProperty possono aggiungere nuovi attributi e oggetti proprietà a un'implementazione specifica del provider.

Esempio

Nell'esempio di codice seguente viene illustrata la procedura precedente per l'applicazione dell'interfaccia IADsProperty per determinare le definizioni di attributi di una proprietà.

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

Requisiti


Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	iads.h

Vedi anche

IADsClass

Idispatch