Методы свойств IADsPropertyValue

Статья
06/13/2023

Методы свойств интерфейса IADsPropertyValue предоставляют доступ к свойствам, описанным в следующей таблице. Дополнительные сведения см. в разделе Методы свойств интерфейса.

Свойства

ADsType

Тип доступа: чтение и запись
Тип данных скрипта: 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

Тип доступа: чтение и запись
Тип данных скрипта: 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

Тип доступа: чтение и запись
Тип данных скрипта: 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

Тип доступа: чтение и запись
Тип данных скрипта: IDispatch
// C++ method syntax HRESULT get_SecurityDescriptor( [out] IDispatch** ppSecurityDescriptor ); HRESULT put_SecurityDescriptor( [in] IDispatch* pSecurityDescriptor );

ВРЕМЯ UTC

Тип доступа: чтение и запись
Тип данных скрипта: DATE
// C++ method syntax HRESULT get_UTCTime( [out] DATE* daUTCTime ); HRESULT put_UTCTime( [in] DATE daUTCTime );

Свойства IADsPropertyValue будут задавать или извлекать только значение свойства указанного типа. Например, свойство CaseIgnoreString для атрибута типа ADSTYPE_DN_STRING, например атрибута различающегося имени , приведет к ошибке. Свойство 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	ВРЕМЯ UTC
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

Поделиться через

Методы свойств IADsPropertyValue

Свойства

Комментарии

Примеры

Требования

См. также раздел

Обратная связь

Дополнительные ресурсы