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 manipular 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 esses 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

   
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