ITPhone::EnumerateAddresses-Methode (tapi3if.h)
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 |