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 |