Metodo ITAddress2::get_Phones (tapi3if.h)

Il metodo get_Phones restituisce un puntatore VARIANT a un ITCollection di oggetti telefono corrispondenti ai dispositivi telefonici che possono essere utilizzati con questo indirizzo.

Questo metodo è destinato alle applicazioni visual Basic e di scripting. Le applicazioni C/C++ devono usare invece il metodo EnumeratePhones .

Sintassi

HRESULT get_Phones(
  [out] VARIANT *pPhones
);

Parametri

[out] pPhones

Puntatore a un valore VARIANT contenente un oggetto ITCollection di puntatori all'interfaccia ITPhone .

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Un dispositivo telefonico dichiara se stesso come disponibile in tutti gli indirizzi che supportano i terminali audio dal TSP impostando il bit PHONEFEATURE_GENERICPHONE nel membro dwPhoneFeatures della struttura PHONECAPS . Un dispositivo telefonico può anche dichiararsi preferito a un indirizzo o a un set di indirizzi restituendo ID indirizzo/riga tramite phoneGetID con la classe del dispositivo tapi/line. Se nessun telefono è disponibile per l'utilizzo con l'indirizzo, questo metodo produce una raccolta vuota e restituisce S_OK.

TAPI chiama il metodo AddRef sull'interfaccia ITPhone restituita da ITAddress2::get_Phones. L'applicazione deve chiamare Release sull'interfaccia ITPhone per liberare le risorse associate.

Requisiti

Vedi anche

EnumeratePhones

ITAddress2