MÉTHODE ITCollection::get__NewEnum (tapi3if.h)
La méthode get__NewEnum obtient un énumérateur pour la collection.
Syntaxe
HRESULT get__NewEnum(
[out] IUnknown **ppNewEnum
);
Paramètres
[out] ppNewEnum
Pointeur vers une interface IUnknown sur un objet énumérateur pour la collection.
Appelez la méthode QueryInterface sur l’interface IUnknown retournée pour obtenir un pointeur vers une interface d’énumération IEnumVARIANT sur la collection. IEnumVARIANT fournit un certain nombre de méthodes que vous pouvez utiliser pour itérer au sein de la collection.
Pour plus d'informations, consultez la section Notes qui suit.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Code de retour | Description |
|---|---|
|
La méthode a réussi. |
|
La mémoire est insuffisante pour effectuer l’opération. |
Remarques
Chaque interface TAPI 3 qui inclut une méthode qui retourne une collection inclut également une méthode qui retourne un pointeur vers une interface d’énumérateur TAPI 3. Si vous programmez en C/C++, il peut être plus facile d’appeler directement la méthode énumérateur d’une collection pour obtenir un objet énumérateur, au lieu d’appeler la méthode ITCollection::get__NewEnum . Par exemple, la méthode ITTAPI::EnumerateAddresses retourne un pointeur vers une interface IEnumAddress . IEnumAddress fournit des méthodes d’énumération pour l’objet Address.
Si vous programmez en Visual Basic, vous n’avez pas besoin d’appeler cette méthode pour énumérer une collection. En effet, vous pouvez appeler implicitement les fonctionnalités de la méthode à l’aide de for... Chaque... Dans... Prochain... Construire.
Configuration requise
| Plateforme cible | Windows |
| En-tête | tapi3if.h (inclure Tapi3.h) |
| Bibliothèque | Uuid.lib |
| DLL | Tapi3.dll |