Método IADsContainer::get__NewEnum (iads.h)

Artículo
08/24/2023

El método IADsContainer::get__NewEnum recupera un objeto enumerador para el contenedor. El objeto enumerador implementa la interfaz IEnumVARIANT para enumerar los elementos secundarios del objeto contenedor.

Sintaxis

HRESULT get__NewEnum(
  [out] IUnknown **retval
);

Parámetros

[out] retval

Puntero a un puntero IUnknown que recibe el objeto enumerador. El autor de la llamada debe liberar esta interfaz cuando ya no sea necesaria.

Valor devuelto

Este método admite los valores devueltos estándar, incluidos S_OK para una operación correcta. Para obtener más información sobre los códigos de error, consulta Códigos de error ADSI.

Comentarios

Hay dos caracteres de subrayado ("__") en el nombre de la función entre "get" y "NewEnum".

En Visual Basic, use ForEach... instrucción para invocar el método IADsContainer::get__NewEnum implícitamente.

En C/C++, use las funciones auxiliares ADsBuildEnumerator, ADsEnumerateNext y AdsFreeEnumerator .

Ejemplos

En el ejemplo de código siguiente se muestra cómo enumerar objetos secundarios en un contenedor.

Dim cont As IADsContainer
On Error GoTo Cleanup

Set cont = GetObject("LDAP://OU=Sales,DC=Fabrikam,DC=com")
For Each obj In cont
  Debug.Print obj.Name
Next

Cleanup:
    If(Err.Number<>0) Then
        MsgBox("An error has occurred. " & Err.Number)
    End If
    Set cont = Nothing

En el ejemplo de código siguiente se muestra cómo enumerar el objeto contenido en un contenedor.

IEnumVARIANT *pEnum = NULL;
IADsContainer *pCont = NULL;
LPUNKNOWN pUnk = NULL;
VARIANT var;
IDispatch *pDisp = NULL;
ulong lFetch;
IADs *pADs = NULL;
 
// In this sample, skip error checking.
ADsGetObject(L"LDAP://OU=Sales,DC=Fabrikam,DC=COM", 
                        IID_IADsContainer, (void**) &pCont);
pCont->get__NewEnum(&pUnk);
pCont->Release();
 
pUnk->QueryInterface(IID_IEnumVARIANT, (void**) &pEnum);
pUnk->Release();
 
// Enumerate. 
HRESULT hr = pEnum->Next(1, &var, &lFetch);
while(SUCCEEDED(hr) && lFetch > 0)
{
    if (lFetch == 1)
    {
        BSTR bstr;

        pDisp = V_DISPATCH(&var);
        pDisp->QueryInterface(IID_IADs, (void**)&pADs); 
        pDisp->Release();
        hr = pADs->get_Name(&bstr);
        if(SUCCEEDED(hr))
        {
            SysFreeString(bstr);
        }

        pADs->Release();
    }

    VariantClear(&var);
    hr = pEnum->Next(1, &var, &lFetch);
};

 
pEnum->Release();

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