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 |