ITAddress2::get_PreferredPhones-Methode (tapi3if.h)
Die get_PreferredPhones-Methode gibt eine Auflistung von Telefonobjekten zurück, die den Telefongeräten entsprechen, die für die Verwendung mit dieser Adresse bevorzugt sind.
Diese Methode ist für Visual Basic- und Skriptanwendungen vorgesehen. C/C++-Anwendungen sollten stattdessen die EnumeratePreferredPhones-Methode verwenden.
Syntax
HRESULT get_PreferredPhones(
[out] VARIANT *pPhones
);
Parameter
[out] pPhones
Zeiger auf einen VARIANT-Wert , der eine ITCollection mit ITPhone-Schnittstellenzeigern enthält.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Wert | Bedeutung |
|---|---|
|
Methode war erfolgreich. |
|
Der pPhones-Parameter ist kein gültiger Zeiger. |
|
Es ist nicht genügend Arbeitsspeicher vorhanden, um das Auflistungsobjekt 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 dieser Adresse verfügbar sind, erzeugt die -Methode eine leere Auflistung und gibt S_OK zurück.
TAPI ruft die AddRef-Methode auf der ITPhone-Schnittstelle auf, die von ITAddress2::get_PreferredPhones zurückgegeben wird. Die Anwendung muss Release auf der ITPhone-Schnittstelle aufrufen, um zugeordnete Ressourcen freizugeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tapi3if.h (Tapi3.h einschließen) |
| Bibliothek | Uuid.lib |
| DLL | Tapi3.dll |