Интерфейс 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