Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |