ITTAPI::EnumerateAddresses-Methode (tapi3if.h)

Artikel
03/04/2024

Die EnumerateAddresses-Methode listet die derzeit verfügbaren Adressen auf. Wird für C- und C++-Anwendungen bereitgestellt. Automatisierungsclientanwendungen, z. B. die in Visual Basic geschriebenen, müssen die get_Addresses-Methode verwenden.

Syntax

HRESULT EnumerateAddresses(
  [out] IEnumAddress **ppEnumAddress
);

Parameter

[out] ppEnumAddress

Zeiger auf die IEnumAddress-Schnittstelle .

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	Bedeutung
S_OK	Methode war erfolgreich.
E_POINTER	Der ppEnumAddress-Parameter ist kein gültiger Zeiger.
E_INVALIDARG	Das TAPI-Objekt wurde nicht initialisiert.
E_OUTOFMEMORY	Zum Ausführen des Vorgangs ist nicht genügend Arbeitsspeicher vorhanden.

Hinweise

Eine Anwendung verwendet diese Enumeration in der Regel, um die Funktionen der einzelnen Adressen zu überprüfen und zu bestimmen, welche für aktuelle Zwecke nützlich sind.

Wenn eine erwartete Adresse nicht gefunden wird, kann dies darauf hindeuten, dass der entsprechende Dienstanbieter nicht installiert wurde oder nicht ordnungsgemäß funktioniert.

TAPI ruft die Addref-Methode für die IEnumAddress-Schnittstelle auf, die von ITTAPI::EnumerateAddresses zurückgegeben wird. Die Anwendung muss die Release-Methode auf der IEnumAddress-Schnittstelle aufrufen, um zugeordnete Ressourcen freizugeben.

Wenn eine Adresse während einer TAPI-Sitzung erstellt oder entfernt wird, wird die Anwendung über die ITTAPIEventNotification-Schnittstelle benachrichtigt. Wenn eine Adresse erstellt wurde, z. B. durch die Installation eines Plug & Play Geräts, gibt ITTAPIEventNotification::Event den TE_ADDRESSCREATE Member der TAPIOBJECT_EVENT-Enumeration zurück. Wenn eine Adresse entfernt wird, gibt ITTAPIEventNotification::EventTE_ADDRESSREMOVE zurück. Das Aufrufen von EnumerateAddresses nach diesen Ereignissen spiegelt die aktuellen Adressen wider.