Metodo ITPhone::EnumerateAddresses (tapi3if.h)

Il metodo EnumerateAddresses enumera gli indirizzi su cui può essere utilizzato il telefono. L'applicazione non deve chiamare ITPhone::Open prima di eseguire questo metodo.

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

Sintassi

HRESULT EnumerateAddresses(
  [out] IEnumAddress **ppEnumAddress
);

Parametri

[out] ppEnumAddress

Puntatore all'interfaccia IEnumAddress .

Valore restituito

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

Commenti

Se nessun telefono è disponibile per l'utilizzo con l'indirizzo, questo metodo produce un'enumerazione vuota e restituisce S_OK.

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 usando phoneGetID con la classe del dispositivo tapi/line. Il metodo EnumerateAddresses restituisce indirizzi identificati in entrambi i modi.

Per ottenere solo gli indirizzi su cui si preferisce il telefono, è possibile chiamare il metodo EnumeratePreferredAddresses .

Un dispositivo telefonico dichiara se stesso come specifico di un indirizzo o di un set di indirizzi restituendo ID indirizzo/riga usando phoneGetID con tapi/line della classe del dispositivo. Anche se la funzione phoneGetID richiede l'handle per un dispositivo telefonico aperto, l'applicazione non deve chiamare il metodo ITPhone::Open prima di chiamare EnumerateAddresses. Ciò è dovuto al fatto che l'implementazione dell'oggetto telefono può aprire il telefono e chiamare phoneGetID durante l'inizializzazione TAPI o quando viene visualizzato un nuovo oggetto telefono.

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

Requisiti

Vedi anche

EnumeratePreferredAddresses

ITPhone