Interface IADsPropertyValue2 (iads.h)

A interface IADsPropertyValue2 é usada para representar o valor de um objeto IADsPropertyEntry em qualquer formato de dados, incluindo tipos de dados novos ou definidos pelo cliente. Essa interface também é útil para lidar com valores de atributo para vários serviços de diretório.

A propriedade IADsPropertyEntry.Values contém uma matriz de objetos IADsPropertyValue2 . Cada um dos objetos IADsPropertyValue contém um único valor do objeto IADsPropertyEntry . Para obter mais informações e um exemplo de código para criar entradas e valores de propriedade totalmente novos, consulte IADsPropertyList.PutPropertyItem.

Antes de chamar os métodos dessas interfaces, você deve chamar IADs.GetInfo ou IADs.GetInfoEx explicitamente para carregar os valores atribuídos do objeto no cache, se o cache não tiver sido inicializado. Depois de modificar os valores do objeto, você deve chamar IADs.SetInfo para salvar as alterações no repositório persistente do diretório subjacente.

Essa interface é mais versátil do que a IADsPropertyValue porque essa interface pode ser usada para obter qualquer tipo de dados. A interface IADsPropertyValue só pode ser usada para obter um número limitado de tipos de dados.

Herança

A interface IADsPropertyValue2 herda da interface IDispatch . IADsPropertyValue2 também tem estes tipos de membros:

Métodos

A interface IADsPropertyValue2 tem esses métodos.

IADsPropertyValue2::GetObjectProperty Recupera um valor de atributo.
IADsPropertyValue2::P utObjectProperty Define um valor de atributo.

Comentários

A tabela a seguir lista os valores de parâmetro lnADsType nos métodos GetObjectProperty e PutObjectProperty para o tipo de dados pvProp correspondente.

Valor lnADsType	Tipo de dados pvProp
ADSTYPE_INVALID	Não disponível.
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_ARRAY | VT_UI4
ADSTYPE_UTC_TIME	VT_DATE
ADSTYPE_LARGE_INTEGER	VT_DISPATCH (IADsLargeInteger)
ADSTYPE_PROV_SPECIFIC	VT_ARRAY | VT_UI1
ADSTYPE_OBJECT_CLASS	Não disponível.
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	Não disponível.
ADSTYPE_DN_WITH_BINARY	VT_DISPATCH (IADsDNWithBinary)
ADSTYPE_DN_WITH_STRING	VT_DISPATCH (IADsDNWithString)

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	iads.h

Confira também

IADsPropertyEntry

IADsPropertyList

IADsPropertyValue

IDispatch