ITAddressTranslation ::EnumerateLocations, méthode (tapi3if.h)
La méthode EnumerateLocations énumère les emplacements d’adresses actuellement disponibles. Cette méthode est fournie pour les applications C et C++. Les applications clientes Automation, telles que celles écrites en Visual Basic, doivent utiliser la méthode get_Locations .
Syntaxe
HRESULT EnumerateLocations(
[out] IEnumLocation **ppEnumLocation
);
Paramètres
[out] ppEnumLocation
Pointeur vers l’objet IEnumLocation créé.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Valeur | Signification |
|---|---|
|
La méthode a réussi. |
|
Le paramètre ppEnumLocations n’est pas un pointeur valide. |
|
La mémoire est insuffisante pour créer un objet. |
Remarques
La méthode EnumerateLocations est un wrapper COM pour la fonction LineGetTranslateCaps TAPI 2.1 et prend les informations d’emplacement de la structure LINETRANSLATECAPS retournée par cette fonction.
TAPI appelle la méthode AddRef sur l’interface IEnumLocation retournée par ITAddressTranslation ::EnumerateLocations. L’application doit appeler Release sur l’interface IEnumLocation pour libérer les ressources qui lui sont associées.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tapi3if.h (inclure Tapi3.h) |
| Bibliothèque | Uuid.lib |
| DLL | Tapi3.dll |