Metodo ITAddress2::EnumeratePhones (tapi3if.h)
Il metodo EnumeratePhones enumera gli oggetti telefono corrispondenti ai dispositivi telefonici che possono essere usati con questo indirizzo.
Questo metodo è destinato alle applicazioni C/C++. Le applicazioni di scripting e Visual Basic devono usare il metodo di get_Phones .
Sintassi
HRESULT EnumeratePhones(
[out] IEnumPhone **ppEnumPhone
);
Parametri
[out] ppEnumPhone
Puntatore alla nuova interfaccia IEnumPhone .
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 eseguire l'operazione. |
|
Il metodo non è riuscito per motivi sconosciuti. |
Commenti
Un dispositivo telefonico dichiara di essere disponibile in tutti gli indirizzi che supportano i terminali audio dal TSP impostando il bit PHONEFEATURE_GENERICPHONE bit nel membro dwPhoneFeatures della struttura PHONECAPS . Un dispositivo telefonico può anche dichiararsi 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::EnumeratePhones. L'applicazione deve chiamare Release nell'interfaccia IEnumPhone per liberare risorse associate.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | tapi3if.h (includere Tapi3.h) |
| Libreria | Uuid.lib |
| DLL | Tapi3.dll |