Interface IADsProperty (iads.h)

A interface IADsProperty foi projetada para gerenciar uma única definição de atributo para um objeto de classe de esquema. Uma definição de atributo especifica os valores mínimo e máximo de uma propriedade, sua sintaxe e se a propriedade dá suporte a vários valores. Outras interfaces envolvidas no gerenciamento de esquema incluem IADsClass e IADsSyntax.

A interface IADsProperty expõe métodos para descrever uma propriedade por nome, sintaxe, intervalos de valores e quaisquer outros atributos definidos. Uma propriedade pode ter vários nomes associados a ela, mas os provedores devem garantir que cada nome seja exclusivo.

Use a interface IADsProperty para determinar em tempo de execução a definição de atributo de uma propriedade compatível com um objeto de serviço de diretório.

Para determinar a definição de atributo em tempo de execução

1. Associar ao objeto de classe de esquema do objeto ADSI.
2. Enumerar atributos obrigatórios ou opcionais acessíveis do objeto de classe de esquema. Ignore esta etapa se você souber que o objeto dá suporte ao atributo de seu interesse.
3. Associe ao contêiner de esquema do objeto de classe de esquema obtido na primeira etapa.
4. Recupere o objeto de definição de atributo da propriedade de interesse do contêiner de esquema.
5. Examine a definição de atributo da propriedade . Talvez você também precise inspecionar o objeto de sintaxe.

Herança

A interface IADsProperty herda de IDispatch e IADs. IADsProperty também tem estes tipos de membros:

Métodos

A interface IADsProperty tem esses métodos.

IADsProperty::Qualifiers Retorna uma coleção de objetos ADSI que descrevem qualificadores adicionais dessa propriedade.

Comentários

Os métodos de interface IADsProperty podem adicionar novos atributos e objetos de propriedade a uma implementação específica do provedor.

Exemplos

O exemplo de código a seguir mostra o procedimento acima para aplicar a interface IADsProperty para determinar definições de atributo de uma propriedade.

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

Requisitos

Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	iads.h

Confira também

Iads

IADsClass

IDispatch