ITAddressTranslation::get_Locations-Methode (tapi3if.h)
Die get_Locations-Methode erstellt eine Sammlung von derzeit verfügbaren Adressstandorten. Diese Methode wird für Automation-Clientanwendungen bereitgestellt, z. B. für die in Visual Basic geschriebenen Anwendungen. C- und C++-Anwendungen müssen die EnumerateLocations-Methode verwenden.
Syntax
HRESULT get_Locations(
[out] VARIANT *pVariant
);
Parameter
[out] pVariant
Zeiger auf VARIANT , der eine ITCollection von ITLocationInfo-Schnittstellenzeigern (Location-Objekte) enthält.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Wert | Bedeutung |
|---|---|
|
Methode war erfolgreich. |
|
Der pVariant-Parameter ist kein gültiger Zeiger. |
|
Zum Ausführen des Vorgangs ist nicht genügend Arbeitsspeicher vorhanden. |
Hinweise
Die get_Locations-Methode ist ein COM-Wrapper für die TAPI 2.1 LineGetTranslateCaps-Funktion und übernimmt Standortinformationen aus der von dieser Funktion zurückgegebenen LINETRANSLATECAPS-Struktur .
TAPI ruft die AddRef-Methode auf der VON ITAddressTranslation::get_Locations zurückgegebenen ITLocationInfo-Schnittstelle auf. Die Anwendung muss Release auf der ITLocationInfo-Schnittstelle aufrufen, um zugeordnete Ressourcen freizugeben.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | tapi3if.h (einschließlich Tapi3.h) |
| Bibliothek | Uuid.lib |
| DLL | Tapi3.dll |