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 |