Metodo ITAddress2::get_PreferredPhones (tapi3if.h)
Il metodo get_PreferredPhones restituisce una raccolta di oggetti telefonici corrispondenti ai dispositivi telefonici preferiti per l'uso con questo indirizzo.
Questo metodo è destinato alle applicazioni visual basic e di scripting. Le applicazioni C/C++ devono usare invece il metodo EnumeratePreferredPhones .
Sintassi
HRESULT get_PreferredPhones(
[out] VARIANT *pPhones
);
Parametri
[out] pPhones
Puntatore a un valore VARIANT contenente un puntatore ITCollection di interfacce ITPhone .
Valore restituito
Questo metodo può restituire uno di questi valori.
| Valore | Significato |
|---|---|
|
Il metodo è riuscito. |
|
Il parametro pPhones non è un puntatore valido. |
|
Memoria insufficiente per allocare l'oggetto raccolta. |
Commenti
Un dispositivo telefonico si dichiara come preferito a un indirizzo o a un set di indirizzi restituendo ID indirizzo/riga usando phoneGetID con tapi /line della classe di dispositivo. Se non sono disponibili telefoni per l'uso con questo indirizzo, il metodo produce una raccolta vuota e restituisce S_OK.
TAPI chiama il metodo AddRef nell'interfaccia ITPhone restituita da ITAddress2::get_PreferredPhones. L'applicazione deve chiamare Release nell'interfaccia ITPhone per liberare risorse associate.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | tapi3if.h (includere Tapi3.h) |
| Libreria | Uuid.lib |
| DLL | Tapi3.dll |