Compartir a través de

Método ITCollection::get__NewEnum (tapi3if.h)

  • Artículo

El método get__NewEnum obtiene un enumerador para la colección.

Sintaxis

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

Parámetros

[out] ppNewEnum

Puntero a una interfaz IUnknown en un objeto enumerador de la colección.

Llame al método QueryInterface en la interfaz IUnknown devuelta para obtener un puntero a una interfaz de enumeración IEnumVARIANT en la colección. IEnumVARIANT proporciona una serie de métodos que puede usar para recorrer en iteración la colección.

Para obtener más información, vea la sección Comentarios que se muestra más adelante.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 El método se realizó correctamente.
E_OUTOFMEMORY
 Existe memoria insuficiente para realizar la operación.

Comentarios

Cada interfaz TAPI 3 que incluye un método que devuelve una colección también incluye un método que devuelve un puntero a una interfaz de enumerador TAPI 3. Si está programando en C/C++, puede ser más fácil llamar directamente al método enumerador de una colección para obtener un objeto enumerador, en lugar de llamar al método ITCollection::get__NewEnum . Por ejemplo, el método ITTAPI::EnumerateAddresses devuelve un puntero a una interfaz IEnumAddress . IEnumAddress proporciona métodos de enumeración para el objeto Address.

Si está programando en Visual Basic, no es necesario llamar a este método para enumerar una colección. Esto se debe a que puede invocar la funcionalidad del método implícitamente mediante for... Cada... En... Próximo... Construir.

Requisitos

   
Plataforma de destino Windows
Encabezado tapi3if.h (incluya Tapi3.h)
Library Uuid.lib
Archivo DLL Tapi3.dll

Consulte también

ITCollection