ITPhone::EnumerateAddresses-Methode (tapi3if.h)

  • Artikel

Die EnumerateAddresses-Methode listet die Adressen auf, für die das Telefon verwendet werden kann. Die Anwendung muss itPhone::Open nicht aufrufen, bevor diese Methode ausgeführt wird.

Diese Methode ist für C/C++-Anwendungen vorgesehen. Visual Basic- und Skriptanwendungen müssen die get_Addresses-Methode verwenden.

Syntax

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

Parameter

[out] ppEnumAddress

Zeiger auf die IEnumAddress-Schnittstelle .

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn keine Telefone für die Verwendung mit der Adresse verfügbar sind, erzeugt diese Methode eine leere Enumeration und gibt S_OK zurück.

Ein Telefongerät deklariert sich als verfügbar für alle Adressen, die Audioterminals unterstützen, indem der TSP das PHONEFEATURE_GENERICPHONE Bit im dwPhoneFeatures-Member der PHONECAPS-Struktur festlegt. Ein Telefongerät kann sich auch als bevorzugt für eine Adresse oder einen Adresssatz deklarieren, indem Adress-/Leitungs-IDs mithilfe von phoneGetID mit der Geräteklasse tapi/line zurückgegeben werden. Die EnumerateAddresses-Methode gibt Adressen zurück, die auf beide Arten identifiziert wurden.

Um nur Adressen abzurufen, für die das Telefon bevorzugt ist, können Sie die EnumeratePreferredAddresses-Methode aufrufen.

Ein Telefongerät deklariert sich als spezifisch für eine Adresse oder einen Adresssatz, indem Adress-/Zeilen-IDs mithilfe von phoneGetID mit der Geräteklasse tapi/line zurückgegeben werden. Obwohl die phoneGetID-Funktion das Handle für ein geöffnetes Telefongerät erfordert, muss die Anwendung nicht die ITPhone::Open-Methode aufrufen, bevor EnumerateAddresses aufgerufen wird. Dies liegt daran, dass die Implementierung des Telefonobjekts das Telefon öffnen und phoneGetID während der TAPI-Initialisierung oder beim Anzeigen eines neuen Telefonobjekts aufrufen kann.

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

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile tapi3if.h (einschließlich Tapi3.h)
Bibliothek Uuid.lib
DLL Tapi3.dll

Weitere Informationen

EnumeratePreferredAddresses

ITPhone