Metodo ITCollection::get__NewEnum (tapi3if.h)

Il metodo get__NewEnum ottiene un enumeratore per la raccolta.

Sintassi

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

Parametri

[out] ppNewEnum

Puntatore a un'interfaccia IUnknown su un oggetto enumeratore per la raccolta.

Chiamare il metodo QueryInterface nell'interfaccia IUnknown restituita per ottenere un puntatore a un'interfaccia di enumVARIANT IEnumVARIANT nella raccolta. IEnumVARIANT fornisce diversi metodi che è possibile usare per scorrere la raccolta.

Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

Valore restituito

Questo metodo può restituire uno di questi valori.

Commenti

Ogni interfaccia TAPI 3 che include un metodo che restituisce una raccolta include anche un metodo che restituisce un puntatore a un'interfaccia enumeratore TAPI 3. Se si esegue la programmazione in C/C++, può essere più semplice chiamare direttamente il metodo enumeratore di una raccolta per ottenere un oggetto enumeratore, anziché chiamare il metodo ITCollection::get__NewEnum . Ad esempio, il metodo ITTAPI::EnumerateAddresses restituisce un puntatore a un'interfaccia IEnumAddress . IEnumAddress fornisce metodi di enumerazione per l'oggetto Address.

Se si esegue la programmazione in Visual Basic, non è necessario chiamare questo metodo per enumerare una raccolta. Ciò è dovuto al fatto che è possibile richiamare la funzionalità del metodo in modo implicito usando for ... Ogni... Pollici... Prossimo... Costruire.

Requisiti

Vedi anche

ITCollection