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

O método get__NewEnum obtém um enumerador para a coleção.

Sintaxe

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

Parâmetros

[out] ppNewEnum

Ponteiro para uma interface IUnknown em um objeto enumerador para a coleção.

Chame o método QueryInterface na interface IUnknown retornada para obter um ponteiro para uma interface de enumeração IEnumVARIANT na coleção. IEnumVARIANT fornece vários métodos que você pode usar para iterar por meio da coleção.

Para obter mais informações, consulte a seção Comentários a seguir.

Valor retornado

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_OUTOFMEMORY	Existe memória insuficiente para executar a operação.

Comentários

Cada interface TAPI 3 que inclui um método que retorna uma coleção também inclui um método que retorna um ponteiro para uma interface de enumerador TAPI 3. Se você estiver programando em C/C++, poderá ser mais fácil chamar o método enumerador de uma coleção diretamente para obter um objeto enumerador, em vez de chamar o método ITCollection::get__NewEnum . Por exemplo, o método ITTAPI::EnumerateAddresses retorna um ponteiro para uma interface IEnumAddress . IEnumAddress fornece métodos de enumeração para o objeto Address.

Se você estiver programando no Visual Basic, não precisará chamar esse método para enumerar uma coleção. Isso ocorre porque você pode invocar a funcionalidade do método implicitamente usando o for... Cada... Em... Próximo... Construir.

Requisitos

Plataforma de Destino	Windows
Cabeçalho	tapi3if.h (inclua Tapi3.h)
Biblioteca	Uuid.lib
DLL	Tapi3.dll

Confira também

ITCollection