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