Partager via


Interface IADsPropertyValue2 (iads.h)

L’interface IADsPropertyValue2 est utilisée pour représenter la valeur d’un objet IADsPropertyEntry dans n’importe quel format de données, y compris les types de données nouveaux ou définis par le client. Cette interface est également utile pour gérer les valeurs d’attribut pour plusieurs services d’annuaire.

La propriété IADsPropertyEntry.Values contient un tableau d’objets IADsPropertyValue2 . Chacun des objets IADsPropertyValue contient une seule valeur de l’objet IADsPropertyEntry . Pour plus d’informations et un exemple de code pour créer des entrées et des valeurs de propriété entièrement nouvelles, consultez IADsPropertyList.PutPropertyItem.

Avant d’appeler les méthodes de cette interface, vous devez appeler IADs.GetInfo ou IADs.GetInfoEx explicitement pour charger les valeurs attribuées de l’objet dans le cache, si le cache n’a pas été initialisé. Après avoir modifié les valeurs de l’objet, vous devez appeler IADs.SetInfo pour enregistrer les modifications apportées au magasin persistant du répertoire sous-jacent.

Cette interface est plus polyvalente que l’IADsPropertyValue , car cette interface peut être utilisée pour obtenir n’importe quel type de données. L’interface IADsPropertyValue ne peut être utilisée que pour obtenir un nombre limité de types de données.

Héritage

L’interface IADsPropertyValue2 hérite de l’interface IDispatch. IADsPropertyValue2 a également les types de membres suivants :

Méthodes

L’interface IADsPropertyValue2 possède ces méthodes.

 
IADsPropertyValue2 ::GetObjectProperty

Récupère une valeur d’attribut.
IADsPropertyValue2 ::P utObjectProperty

Définit une valeur d’attribut.

Remarques

Le tableau suivant répertorie les valeurs de paramètre lnADsType dans les méthodes GetObjectProperty et PutObjectProperty du type de données pvProp correspondant.

valeur lnADsType Type de données pvProp
ADSTYPE_INVALID Non disponible.
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 Non disponible.
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 Non disponible.
ADSTYPE_DN_WITH_BINARY VT_DISPATCH (IADsDNWithBinary)
ADSTYPE_DN_WITH_STRING VT_DISPATCH (IADsDNWithString)

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista
Serveur minimal pris en charge Windows Server 2008
Plateforme cible Windows
En-tête iads.h

Voir aussi

IADsPropertyEntry

IADsPropertyList

IADsPropertyValue

IDispatch