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.
| Codice restituito | Descrizione |
|---|---|
|
Il metodo è riuscito. |
|
Memoria insufficiente per eseguire l'operazione. |
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
| Piattaforma di destinazione | Windows |
| Intestazione | tapi3if.h (include Tapi3.h) |
| Libreria | Uuid.lib |
| DLL | Tapi3.dll |