ITAddressTranslation::get_Locations méthode (tapi3if.h)
La méthode get_Locations crée une collection d’emplacements d’adresses actuellement disponibles. Cette méthode est fournie pour les applications clientes Automation, telles que celles écrites en Visual Basic. Les applications C et C++ doivent utiliser la méthode EnumerateLocations .
Syntaxe
HRESULT get_Locations(
[out] VARIANT *pVariant
);
Paramètres
[out] pVariant
Pointeur vers VARIANT contenant un ITCollection de pointeurs d’interface ITLocationInfo (objets location).
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Valeur | Signification |
|---|---|
|
La méthode a réussi. |
|
Le paramètre pVariant n’est pas un pointeur valide. |
|
La mémoire est insuffisante pour effectuer l’opération. |
Remarques
La méthode get_Locations 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 ITLocationInfo retournée par ITAddressTranslation::get_Locations. L’application doit appeler Release sur l’interface ITLocationInfo pour libérer les ressources qui lui sont associées.
Configuration requise
| Plateforme cible | Windows |
| En-tête | tapi3if.h (inclure Tapi3.h) |
| Bibliothèque | Uuid.lib |
| DLL | Tapi3.dll |