Share via

IADsPropertyValue 속성 메서드

  • 아티클

IADsPropertyValue 인터페이스의 속성 메서드는 다음 표에 설명된 속성에 대한 액세스를 제공합니다. 자세한 내용은 인터페이스 속성 메서드를 참조하세요.

속성

ADsType

값 속성의 ADSTYPEENUM 열거형에서 가져온 속성 값의 데이터 형식입니다.

액세스 형식: 읽기/쓰기

스크립팅 데이터 형식: LONG

// C++ method syntax
HRESULT get_ADsType(
  [out] LONG* ADsType
);
HRESULT put_ADsType(
  [in] LONG ADsType
);

Boolean

부울 값을 지정합니다.

액세스 형식: 읽기/쓰기

스크립팅 데이터 형식: LONG

// C++ method syntax
HRESULT get_Boolean(
  [out] LONG* lnBoolean
);
HRESULT put_Boolean(
  [in] LONG lnBoolean
);

CaseExactString

해석할 문자열입니다. 대/소문자 구분.

액세스 형식: 읽기/쓰기

데이터 형식 스크립팅: BSTR

// C++ method syntax
HRESULT get_CaseExactString(
  [out] BSTR* bstrCaseExactString
);
HRESULT put_CaseExactString(
  [in] BSTR bstrCaseExactString
);

CaseIgnoreString

해석할 문자열입니다. 대/소문자를 구분하지 않습니다.

액세스 형식: 읽기/쓰기

데이터 형식 스크립팅: BSTR

// C++ method syntax
HRESULT get_CaseIgnoreString(
  [out] BSTR* bstrCaseIgnoreString
);
HRESULT put_CaseIgnoreString(
  [in] BSTR bstrCaseIgnoreString
);

DNString

디렉터리 서비스 값 개체의 고유 이름(경로)을 식별하는 문자열입니다.

액세스 형식: 읽기/쓰기

데이터 형식 스크립팅: BSTR

// C++ method syntax
HRESULT get_DNString(
  [out] BSTR* bstrDNString
);
HRESULT put_DNString(
  [in] BSTR bstrDNString
);

정수

정수 값.

액세스 형식: 읽기/쓰기

스크립팅 데이터 형식: LONG

// C++ method syntax
HRESULT get_Integer(
  [out] LONG* lnInteger
);
HRESULT put_Integer(
  [in] LONG lnInteger
);

LargeInteger

이 값에 대해 IADsLargeInteger를 구현하는 개체의 IDispatch 인터페이스에 대한 포인터입니다.

액세스 형식: 읽기/쓰기

스크립팅 데이터 형식: IDispatch

// C++ method syntax
HRESULT get_LargeInteger(
  [out] IDispatch** ppLargeInteger
);
HRESULT put_LargeInteger(
  [in] IDispatch* pLargeInteger
);

NumericString

해석할 텍스트입니다. 숫자 형식입니다.

액세스 형식: 읽기/쓰기

데이터 형식 스크립팅: BSTR

// C++ method syntax
HRESULT get_NumericString(
  [out] BSTR* bstrNumericString
);
HRESULT put_NumericString(
  [in] BSTR bstrNumericString
);

OctetString

1 바이트 문자의 변형 배열입니다.

액세스 형식: 읽기/쓰기

데이터 형식 스크립팅: VARIANT

// C++ method syntax
HRESULT get_OctetString(
  [in] VARIANT* vOctetString
);
HRESULT put_OctetString(
  [in] VARIANT* vOctetString
);

PrintableString

문자열을 표시하거나 인쇄합니다.

액세스 형식: 읽기/쓰기

데이터 형식 스크립팅: BSTR

// C++ method syntax
HRESULT get_PrintableString(
  [out] BSTR* bstrPrintableString
);
HRESULT put_PrintableString(
  [in] BSTR bstrPrintableString
);

SecurityDescriptor

이 값에 대해 IADsSecurityDescriptor를 구현하는 개체의 IDispatch 인터페이스에 대한 포인터입니다.

액세스 형식: 읽기/쓰기

스크립팅 데이터 형식: IDispatch

// C++ method syntax
HRESULT get_SecurityDescriptor(
  [out] IDispatch** ppSecurityDescriptor
);
HRESULT put_SecurityDescriptor(
  [in] IDispatch* pSecurityDescriptor
);

UTCTime

UTC(협정 세계시) 형식으로 표현된 VT_DATE 형식의 날짜입니다.

액세스 형식: 읽기/쓰기

스크립팅 데이터 형식: DATE

// C++ method syntax
HRESULT get_UTCTime(
  [out] DATE* daUTCTime
);
HRESULT put_UTCTime(
  [in] DATE daUTCTime
);

설명

IADsPropertyValue 속성은 지정된 형식의 속성 값만 설정하거나 검색합니다. 예를 들어 distinguishedName 특성과 같이 ADSTYPE_DN_STRING 형식의 특성에 대한 CaseIgnoreString 속성에 오류가 발생합니다. CaseIgnoreString 속성은 ADS_CASE_IGNORE_STRING 형식의 특성에서만 작동합니다. 다음 표에서는 ADSTYPEENUM 값을 해당 특성 형식에 액세스하는 데 사용할 수 있는 해당 IADsPropertyValue 속성에 매핑합니다. ADSTYPEENUM 값이 이 테이블에 나열되지 않으면 IADsPropertyValue 인터페이스에서 사용할 수 없습니다. IADsPropertyValue2 인터페이스를 사용하여 다른 형식의 데이터를 가져와야 합니다.

ADSTYPEENUM 값 IADsPropertyValue 속성
ADSTYPE_DN_STRING DNString
ADSTYPE_CASE_EXACT_STRING CaseExactString
ADSTYPE_CASE_IGNORE_STRING CaseIgnoreString
ADSTYPE_PRINTABLE_STRING PrintableString
ADSTYPE_NUMERIC_STRING NumericString
ADSTYPE_BOOLEAN Boolean
ADSTYPE_INTEGER 정수
ADSTYPE_OCTET_STRING OctetString
ADSTYPE_UTC_TIME UTCTime
ADSTYPE_LARGE_INTEGER LargeInteger
ADSTYPE_NT_SECURITY_DESCRIPTOR SecurityDescriptor

예제

다음 코드 예제에서는 검색 하는 방법을 보여 입니다 속성 목록에서 속성입니다.

Dim propList As IADsPropertyList
Dim propEntry As IADsPropertyEntry
Dim propVal As IADsPropertyValue

On Error GoTo Cleanup
 
' Retrieve the property list.
Set propList = GetObject("LDAP://dc01/DC=Fabrikam,DC=com")
propList.GetInfo
 
' Retrieve a property entry. If you are certain of the property type,
' replace ADSTYPE_UNKNOWN with the actual property type.
Set propEntry = propList.GetPropertyItem("description", ADSTYPE_UNKNOWN)
 
' Print the property entry values.
For Each v In propEntry.Values
    Set propVal = v
    Select Case propVal.ADsType
        Case ADSTYPE_CASE_EXACT_STRING
            Debug.Print propVal.CaseExactString
        Case ADSTYPE_CASE_IGNORE_STRING
            Debug.Print propVal.CaseIgnoreString
        Case Else
            Debug.Print "Unable to handle a property of type: " & propVal.ADsType
    End Select
    
Next

Cleanup:
    If (Err.Number<>0) Then
       Debug.Print "An error has occurred. " & Err.Number
    End If
    Set propList = Nothing
    Set propEntry = Nothing
    Set propVal = Nothing

다음 코드에서는 IADsPropertyValue::get_CaseIgnoreString 사용하여 속성 목록에서 description 속성의 값을 검색하는 방법을 보여 줍니다.

#include <activeds.h>
#include <stdio.h>
 
IADsPropertyList *pList = NULL;
IADsPropertyEntry *pEntry = NULL;
IADsPropertyValue *pVal = NULL;
IADs *pObj = NULL;
VARIANT var, varItem;
BSTR valStr;
IEnumVARIANT *pEnum = NULL;
LONG lstart = 0;
LONG lend = 0;
LONG lADsType = ADSTYPE_UNKNOWN;
 
VariantInit(&var);
VariantInit(&varItem);
 
// Bind to the directory object.
HRESULT hr = ADsGetObject(L"LDAP://dc01/DC=Fabrikam,DC=com",
                          IID_IADsPropertyList,
                          (void**)&pList);

if(FAILED(hr)){goto Cleanup;}

// Initialize the property cache.
hr = pList->QueryInterface(IID_IADs,(void**)&pObj);
if(FAILED(hr)){goto Cleanup;}

pObj->GetInfo();
pObj->Release();
 
// Retrieve the property entry.
hr = pList->GetPropertyItem(CComBSTR("description"), ADSTYPE_CASE_IGNORE_STRING, &var);
pList->Release();
if(FAILED(hr)){goto Cleanup;}

hr = V_DISPATCH(&var)->QueryInterface(IID_IADsPropertyEntry,
                                      (void**)&pEntry);
VariantClear(&var);
if(FAILED(hr)){goto Cleanup;}
 
// Retrieve the value array of the property entry.
hr = pEntry->get_Values(&var);
if(FAILED(hr)){goto Cleanup;}

SAFEARRAY *sa = V_ARRAY( &var );
 
// Retrieve the lower and upper bound. Iterate and print the values.
hr = SafeArrayGetLBound( sa, 1, &lstart );
hr = SafeArrayGetUBound( sa, 1, &lend );
printf(" Property value(s) = ");
for ( long idx=lstart; idx < lend+1; idx++ )    {
    hr = SafeArrayGetElement( sa, &idx, &varItem );
    hr = V_DISPATCH(&varItem)->QueryInterface(IID_IADsPropertyValue,
                                              (void**)&pVal);
    if(FAILED(hr)){goto Cleanup;}

    pVal->get_ADsType(&lADsType);

    switch(lADsType)
    {
        case ADSTYPE_CASE_IGNORE_STRING:
        {
            hr = pVal->get_CaseIgnoreString(&valStr);
            break;
        }
        case ADSTYPE_CASE_EXACT_STRING:
        {
            hr = pVal->get_CaseExactString(&valStr);
            break;
        }
        default:
        {
            valStr = SysAllocString(L"Unable to handle a property of this type");
            break;
        }
    }

    if(FAILED(hr)){goto Cleanup;}
    printf(" %S ", valStr);
    SysFreeString(valStr);
    VariantClear(&varItem);
}
printf("\n");

Cleanup:
    if(pList)
        pList = NULL;

    if(pEntry)
        pEntry = NULL;

    if(pVal)
        pVal = NULL;

    if(pObj)
        pObj = NULL;

    if(pEnum)
        pEnum = NULL;

    SysFreeString(valStr);
    VariantClear(&varItem);
    VariantClear(&var);

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows Vista
지원되는 최소 서버
 Windows Server 2008
헤더
Iads.h
DLL
Activeds.dll
IID
 IID_IADsPropertyValue 79FA9AD0-A97C-11D0-8534-00C04FD8D503으로 정의됩니다.

추가 정보

IADsPropertyValue

ADSTYPEENUM

IADsPropertyEntry

IADsPropertyList

IADsPropertyValue2

IADsSecurityDescriptor

IDispatch