IADsProperty 인터페이스(iads.h)

아티클
08/24/2023

IADsProperty 인터페이스는 스키마 클래스 개체에 대한 단일 특성 정의를 관리하도록 설계되었습니다. 특성 정의는 속성의 최소 및 최대 값, 해당 구문 및 속성이 여러 값을 지원하는지 여부를 지정합니다. 스키마 관리와 관련된 다른 인터페이스로는 IADsClass 및 IADsSyntax가 있습니다.

IADsProperty 인터페이스는 이름, 구문, 값 범위 및 기타 정의된 특성별로 속성을 설명하는 메서드를 노출합니다. 속성에는 여러 이름이 연결되어 있을 수 있지만 공급자는 각 이름이 고유한지 확인해야 합니다.

IADsProperty 인터페이스를 사용하여 런타임에 디렉터리 서비스 개체에서 지원하는 속성의 특성 정의를 확인합니다.

런타임에 특성 정의를 확인하려면

ADSI 개체의 스키마 클래스 개체에 바인딩합니다.
스키마 클래스 개체에서 액세스할 수 있는 필수 또는 선택적 특성을 열거합니다. 개체가 관심 있는 특성을 지원한다는 것을 알고 있는 경우 이 단계를 건너뜁니다.
첫 번째 단계에서 가져온 스키마 클래스 개체의 스키마 컨테이너에 바인딩합니다.
스키마 컨테이너에서 관심 있는 속성의 특성 정의 개체를 검색합니다.
속성의 특성 정의를 검사합니다. 구문 개체를 검사해야 할 수도 있습니다.

상속

IADsProperty 인터페이스는 IDispatch 및 IAD에서 상속됩니다. IADsProperty 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IADsProperty 인터페이스에는 이러한 메서드가 있습니다.


IADsProperty::Qualifiers 이 속성의 추가 한정자를 설명하는 ADSI 개체의 컬렉션을 반환합니다.

설명

IADsProperty 인터페이스 메서드는 공급자별 구현에 새 특성 및 속성 개체를 추가할 수 있습니다.

예제

다음 코드 예제에서는 속성의 특성 정의를 확인 하려면 IADsProperty 인터페이스를 적용 하기 위한 위의 프로시저를 보여 줍니다.

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