IADsPropertyList::Next-Methode (iads.h)
Die IADsPropertyList::Next-Methode ruft das nächste Element in der Eigenschaftenliste ab. Das zurückgegebene Element ist ein Property Entry-Objekt.
Syntax
HRESULT Next(
[out] VARIANT *pVariant
);
Parameter
[out] pVariant
Adresse einer vom Aufrufer zugeordneten Variablen, die den Wert des nächsten Elements in der Eigenschaftenliste enthält. Der Rückgabewert von VT_DISPATCH bezieht sich auf einen IDispatch-Schnittstellenzeiger auf ein Objekt, das die IADsPropertyEntry-Schnittstelle implementiert.
Rückgabewert
Diese Methode unterstützt die HRESULT-Standardwerte , einschließlich S_OK , wenn das Element abgerufen wird. Wenn das letzte Element in der Liste zurückgegeben wird, unterscheidet sich der zurückgegebene Rückgabewert je nach verwendetem Anbieter. Die folgenden Codes werden verwendet, um anzugeben, dass das letzte Element in der Liste abgerufen wurde:
Weitere Informationen und andere Rückgabewerte finden Sie unter ADSI-Fehlercodes.
Hinweise
Sie müssen pVariant mithilfe von VariantClear löschen, wenn der von der Next-Methode zurückgegebene Wert nicht mehr erforderlich ist.
Beispiele
Im folgenden Codebeispiel wird gezeigt, wie Sie eine Eigenschaftenliste mithilfe der Next-Methode durchlaufen.
Dim propList As IADsPropertyList
Dim v as Variant
Dim propVal As IADsPropertyValue
On Error Resume Next
Set propList = GetObject("LDAP://dc01/DC=Fabrikam,DC=com")
propList.GetInfo
Set v = propList.Next()
While (Not (IsNull(v)) And Err.Number = 0)
Set propEnty = v
Debug.Print v.Name
Debug.Print v.AdsType
Set v = propList.Next
Wend
Im folgenden C++-Codebeispiel wird gezeigt, wie die IADsPropertyList::Next-Methode verwendet wird.
////////////////////////////////////
// Function used to retrieve an entry using the
// IADsPropertyList::Next method.
// name: GetNextEntry
// input: IADsPropertyList*
// return: IADsPropertyEntry
// uses: IADsPropertyList::Next
/////////////////////////////////////////////////////////
IADsPropertyEntry* GetNextEntry(IADsPropertyList* pList)
{
VARIANT var;
VariantInit(&var);
IADsPropertyEntry *pEntry;
if(!pList)
{
_tprintf("An error has occurred.");
return NULL;
}
HRESULT hr = pList->Next(&var);
hr = V_DISPATCH(&var)->QueryInterface(IID_IADsPropertyEntry,
(void**)&pEntry);
VariantClear(&var);
return pEntry;
}
Anforderungen
Unterstützte Mindestversion (Client) | Windows Vista |
Unterstützte Mindestversion (Server) | Windows Server 2008 |
Zielplattform | Windows |
Kopfzeile | iads.h |
DLL | Activeds.dll |