Método IADsPropertyList::Next (iads.h)

Artículo
08/24/2023

El método IADsPropertyList::Next obtiene el siguiente elemento de la lista de propiedades. El elemento devuelto es un objeto Property Entry.

Sintaxis

HRESULT Next(
  [out] VARIANT *pVariant
);

Parámetros

[out] pVariant

Dirección de una variable asignada por el autor de la llamada que contiene el valor del siguiente elemento de la lista de propiedades. El valor devuelto de VT_DISPATCH hace referencia a un puntero de interfaz IDispatch a un objeto que implementa la interfaz IADsPropertyEntry .

Valor devuelto

Este método admite los valores HRESULT estándar, incluidos S_OK si se obtiene el elemento. Cuando se devuelve el último elemento de la lista, el valor devuelto que se devuelve variará en función del proveedor que se use. Los códigos siguientes se usan para indicar que se obtuvo el último elemento de la lista:

Para obtener más información y otros valores devueltos, vea Códigos de error adsi.

Comentarios

Debe borrar pVariant mediante VariantClear cuando el valor devuelto por el método Next ya no es necesario.

Ejemplos

En el ejemplo de código siguiente se muestra cómo recorrer una lista de propiedades mediante el método Next .

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

En el siguiente ejemplo de código de C++ se muestra cómo trabajar con el método IADsPropertyList::Next .

////////////////////////////////////
// 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;
}

Requisitos


Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	iads.h
Archivo DLL	Activeds.dll