ITAddressTranslation::EnumerateLocations-Methode (tapi3if.h)

Artikel
03/02/2024

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
S_OK	Methode war erfolgreich.
E_POINTER	Der ppEnumLocations-Parameter ist kein gültiger Zeiger.
E_OUTOFMEMORY	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.