IADsPropertyList::Next-Methode (iads.h)

Artikel
08/24/2023

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