ITAddressTranslation::EnumerateLocations-Methode (tapi3if.h)
Die EnumerateLocations-Methode listet die derzeit verfügbaren Adressstandorte auf. Diese Methode wird für C- und C++-Anwendungen bereitgestellt. Automatisierungsclientanwendungen, z. B. die in Visual Basic geschriebenen, müssen die get_Locations-Methode verwenden.
Syntax
HRESULT EnumerateLocations(
[out] IEnumLocation **ppEnumLocation
);
Parameter
[out] ppEnumLocation
Zeiger auf das erstellte IEnumLocation-Objekt .
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Wert | Bedeutung |
|---|---|
|
Methode war erfolgreich. |
|
Der ppEnumLocations-Parameter ist kein gültiger Zeiger. |
|
Es ist nicht genügend Arbeitsspeicher vorhanden, um ein Objekt zu erstellen. |
Hinweise
Die EnumerateLocations-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 IEnumLocation-Schnittstelle auf, die von ITAddressTranslation::EnumerateLocations zurückgegeben wird. Die Anwendung muss Release auf der IEnumLocation-Schnittstelle aufrufen, um zugeordnete Ressourcen freizugeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tapi3if.h (einschließlich Tapi3.h) |
| Bibliothek | Uuid.lib |
| DLL | Tapi3.dll |