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

Weitere Informationen

IADsPropertyEntry

IADsPropertyList

IADsPropertyValue

IDispatch