Compartilhar via


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

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

Confira também

Códigos de erro ADSI

IADsPropertyEntry

IADsPropertyList

Métodos de propriedade IADsPropertyList

IDispatch