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

Artigo
08/24/2023

O método IADsPropertyList::Next obtém o próximo item na lista de propriedades. O item retornado é um objeto Property Entry.

Sintaxe

HRESULT Next(
  [out] VARIANT *pVariant
);

Parâmetros

[out] pVariant

Endereço de uma variável alocada pelo chamador que contém o valor do próximo item na lista de propriedades. O valor retornado de VT_DISPATCH refere-se a um ponteiro de interface IDispatch para um objeto que implementa a interface IADsPropertyEntry .

Valor retornado

Esse método dá suporte aos valores HRESULT padrão, incluindo S_OK se o item for obtido. Quando o último item na lista for retornado, o valor retornado será diferente dependendo de qual provedor é usado. Os seguintes códigos são usados para indicar que o último item na lista foi obtido:

Para obter mais informações e outros valores retornados, consulte Códigos de erro ADSI.

Comentários

Você deve limpar pVariant usando VariantClear quando o valor retornado pelo método Next não for mais necessário.

Exemplos

O exemplo de código a seguir mostra como percorrer uma lista de propriedades usando o 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

O exemplo de código C++ a seguir mostra como trabalhar o 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 com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	iads.h
DLL	Activeds.dll