Metodo ITAddress2::EnumeratePreferredPhones (tapi3if.h)
Il metodo EnumeratePreferredPhones enumera gli oggetti telefono preferiti per questo indirizzo.
Questo metodo è destinato alle applicazioni C/C++. Le applicazioni di scripting e Visual Basic devono usare il metodo get_PreferredPhones .
Sintassi
HRESULT EnumeratePreferredPhones(
[out] IEnumPhone **ppEnumPhone
);
Parametri
[out] ppEnumPhone
Puntatore alla posizione in cui, in caso di esito positivo, questo metodo inserisce un puntatore a un oggetto enumerazione che contiene l'elenco restituito di telefoni.
Valore restituito
Questo metodo può restituire uno di questi valori.
| Valore | Significato |
|---|---|
|
Il metodo è riuscito. |
|
Il parametro ppEnumPhone non è un puntatore valido. |
|
Memoria insufficiente per allocare l'oggetto di enumerazione. |
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 l'indirizzo, questo metodo produce un'enumerazione vuota e restituisce S_OK.
TAPI chiama il metodo AddRef nell'interfaccia IEnumPhone restituita da ITAddress2::EnumeratePreferredPhones. L'applicazione deve chiamare Release nell'interfaccia IEnumPhone per liberare risorse associate.
Requisiti
| Piattaforma di destinazione | Windows |
| Intestazione | tapi3if.h (includere Tapi3.h) |
| Libreria | Uuid.lib |
| DLL | Tapi3.dll |