IADsPropertyValue2-Schnittstelle (iads.h)
Die IADsPropertyValue2-Schnittstelle wird verwendet, um den Wert eines IADsPropertyEntry-Objekts in einem beliebigen Datenformat darzustellen, einschließlich neuer oder kundendefinierter Datentypen. Diese Schnittstelle ist auch nützlich für die Behandlung von Attributwerten für mehrere Verzeichnisdienste.
Die IADsPropertyEntry.Values-Eigenschaft enthält ein Array von IADsPropertyValue2-Objekten . Jedes der IADsPropertyValue-Objekte enthält einen einzelnen Wert des IADsPropertyEntry-Objekts . Weitere Informationen und ein Codebeispiel zum Erstellen völlig neuer Eigenschaftseinträge und -werte finden Sie unter IADsPropertyList.PutPropertyItem.
Vor dem Aufrufen der Methoden dieser Schnittstellen müssen Sie IADs.GetInfo oder IADs.GetInfoEx aufrufen, um die zugewiesenen Werte des Objekts explizit in den Cache zu laden, wenn der Cache nicht initialisiert wurde. Nachdem Sie die Werte des Objekts geändert haben, müssen Sie IADs.SetInfo aufrufen, um die Änderungen im persistenten Speicher des zugrunde liegenden Verzeichnisses zu speichern.
Diese Schnittstelle ist vielseitiger als IADsPropertyValue , da diese Schnittstelle zum Abrufen eines beliebigen Datentyps verwendet werden kann. Die IADsPropertyValue-Schnittstelle kann nur zum Abrufen einer begrenzten Anzahl von Datentypen verwendet werden.
Vererbung
Die IADsPropertyValue2-Schnittstelle erbt von der IDispatch-Schnittstelle . IADsPropertyValue2 verfügt auch über folgende Membertypen:
Methoden
Die IADsPropertyValue2-Schnittstelle verfügt über diese Methoden.
| IADsPropertyValue2::GetObjectProperty Ruft einen Attributwert ab. |
| IADsPropertyValue2::P utObjectProperty Legt einen Attributwert fest. |
Hinweise
In der folgenden Tabelle sind die lnADsType-Parameterwerte in den Methoden GetObjectProperty und PutObjectProperty für den entsprechenden pvProp-Datentyp aufgeführt.
| lnADsType-Wert | pvProp-Datentyp |
|---|---|
| ADSTYPE_INVALID | Nicht verfügbar. |
| 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 | Nicht verfügbar. |
| 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 | Nicht verfügbar. |
| ADSTYPE_DN_WITH_BINARY | VT_DISPATCH (IADsDNWithBinary) |
| ADSTYPE_DN_WITH_STRING | VT_DISPATCH (IADsDNWithString) |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | iads.h |