ITAddress2::EnumeratePreferredPhones-Methode (tapi3if.h)
Die EnumeratePreferredPhones-Methode listet die bevorzugten Telefonobjekte für diese Adresse auf.
Diese Methode ist für C/C++-Anwendungen vorgesehen. Visual Basic- und Skriptanwendungen müssen die methode get_PreferredPhones verwenden.
Syntax
HRESULT EnumeratePreferredPhones(
[out] IEnumPhone **ppEnumPhone
);
Parameter
[out] ppEnumPhone
Zeiger auf den Speicherort, an dem diese Methode bei Erfolg einen Zeiger auf ein Enumerationsobjekt platziert, das die zurückgegebene Liste von Telefonen enthält.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Wert | Bedeutung |
|---|---|
|
Methode war erfolgreich. |
|
Der ppEnumPhone-Parameter ist kein gültiger Zeiger. |
|
Es ist nicht genügend Arbeitsspeicher vorhanden, um das Enumerationsobjekt zuzuordnen. |
Hinweise
Ein Telefongerät deklariert sich selbst als bevorzugt gegenüber einer Adresse oder einem Satz von Adressen, indem es Adressen-/Zeilen-IDs mit phoneGetID mit der Geräteklasse tapi/line zurückgibt. 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.
TAPI ruft die AddRef-Methode auf der IEnumPhone-Schnittstelle auf, die von ITAddress2::EnumeratePreferredPhones zurückgegeben wird. Die Anwendung muss Release auf der IEnumPhone-Schnittstelle aufrufen, um zugeordnete Ressourcen freizugeben.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | tapi3if.h (Tapi3.h einschließen) |
| Bibliothek | Uuid.lib |
| DLL | Tapi3.dll |