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


Интерфейс IADsPropertyValue2 (iads.h)

Интерфейс IADsPropertyValue2 используется для представления значения объекта IADsPropertyEntry в любом формате данных, включая новые или определяемые пользователем типы данных. Этот интерфейс также полезен для обработки значений атрибутов для нескольких служб каталогов.

Свойство IADsPropertyEntry.Values содержит массив объектов IADsPropertyValue2 . Каждый из объектов IADsPropertyValue содержит одно значение объекта IADsPropertyEntry . Дополнительные сведения и пример кода для создания полностью новых записей и значений свойств см. в разделе IADsPropertyList.PutPropertyItem.

Перед вызовом методов этих интерфейсов необходимо явно вызвать IADs.GetInfo или IADs.GetInfoEx , чтобы загрузить назначенные значения объекта в кэш, если кэш не инициализирован. После изменения значений объекта необходимо вызвать IADs.SetInfo , чтобы сохранить изменения в постоянном хранилище базового каталога.

Этот интерфейс является более универсальным, чем IADsPropertyValue , так как его можно использовать для получения любого типа данных. Интерфейс IADsPropertyValue можно использовать только для получения ограниченного количества типов данных.

Наследование

Интерфейс IADsPropertyValue2 наследуется от интерфейса IDispatch . IADsPropertyValue2 также имеет следующие типы элементов:

Методы

Интерфейс IADsPropertyValue2 содержит следующие методы.

 
IADsPropertyValue2::GetObjectProperty

Извлекает значение атрибута.
IADsPropertyValue2::P utObjectProperty

Задает значение атрибута.

Комментарии

В следующей таблице перечислены значения параметров lnADsType в методах GetObjectProperty и PutObjectProperty для соответствующего типа данных pvProp .

Значение lnADsType Тип данных pvProp
ADSTYPE_INVALID Недоступно.
ADSTYPE_DN_STRING VT_BSTR
ADSTYPE_CASE_EXACT_STRING VT_BSTR
ADSTYPE_CASE_IGNORE_STRING VT_BSTR
ADSTYPE_PRINTABLE_STRING VT_BSTR
ADSTYPE_NUMERIC_STRING VT_BSTR
ADSTYPE_BOOLEAN VT_BOOL
ADSTYPE_INTEGER VT_I4
ADSTYPE_OCTET_STRING | VT_ARRAYVT_UI4
ADSTYPE_UTC_TIME VT_DATE
ADSTYPE_LARGE_INTEGER VT_DISPATCH (IADsLargeInteger)
ADSTYPE_PROV_SPECIFIC | VT_ARRAYVT_UI1
ADSTYPE_OBJECT_CLASS Недоступно.
ADSTYPE_CASEIGNORE_LIST VT_DISPATCH (IADsCaseIgnoreList)
ADSTYPE_OCTET_LIST VT_DISPATCH (IADsOctetList)
ADSTYPE_PATH VT_DISPATCH (IADsPath)
ADSTYPE_POSTALADDRESS VT_DISPATCH (IADsPostalAddress)
ADSTYPE_TIMESTAMP VT_DISPATCH (IADsTimestamp)
ADSTYPE_BACKLINK VT_DISPATCH (IADsBackLink)
ADSTYPE_TYPEDNAME VT_DISPATCH (IADsTypedName)
ADSTYPE_HOLD VT_DISPATCH (IADsHold)
ADSTYPE_NETADDRESS VT_DISPATCH (IADsNetAddress)
ADSTYPE_REPLICAPOINTER VT_DISPATCH (IADsReplicaPointer)
ADSTYPE_FAXNUMBER VT_DISPATCH (IADsFaxNumber)
ADSTYPE_EMAIL VT_DISPATCH (IADsEmail)
ADSTYPE_NT_SECURITY_DESCRIPTOR VT_DISPATCH (IADsSecurityDescriptor)
ADSTYPE_UNKNOWN Недоступно.
ADSTYPE_DN_WITH_BINARY VT_DISPATCH (IADsDNWithBinary)
ADSTYPE_DN_WITH_STRING VT_DISPATCH (IADsDNWithString)

Требования

Требование Значение
Минимальная версия клиента Windows Vista
Минимальная версия сервера Windows Server 2008
Целевая платформа Windows
Header iads.h

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

IADsPropertyEntry

IADsPropertyList

IADsPropertyValue

IDispatch