Método ITPhone::get_Addresses (tapi3if.h)
El método get_Addresses devuelve una colección de direcciones en las que se puede usar el teléfono. La aplicación no tiene que llamar a ITPhone::Open antes de ejecutar este método.
Este método está diseñado para Visual Basic y aplicaciones de scripting. En su lugar, las aplicaciones de C/C++ deben usar el método EnumerateAddresses .
Sintaxis
HRESULT get_Addresses(
[out] VARIANT *pAddresses
);
Parámetros
[out] pAddresses
Puntero a una VARIANTE que contiene una ITCollection de punteros de interfaz ITAddress .
Valor devuelto
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
Un dispositivo telefónico se declara como disponible en todas las direcciones que admiten terminales de audio mediante el TSP estableciendo el bit PHONEFEATURE_GENERICPHONE en el miembro dwPhoneFeatures de la estructura PHONECAPS . Un dispositivo telefónico también puede declararse como preferido para una dirección o un conjunto de direcciones devolviendo identificadores de dirección/línea mediante phoneGetID con la clase de dispositivo tapi/line. El método get_Addresses devuelve direcciones que se han identificado de ambas maneras.
Para obtener solo las direcciones en las que se prefiere el teléfono, puede llamar al método get_PreferredAddresses .
La aplicación no tiene que llamar al método ITPhone::Open antes de llamar a get_Addresses. Esto se debe a que la implementación del objeto phone puede abrir el teléfono y llamar a phoneGetID durante la inicialización tapi o cuando aparece un nuevo objeto de teléfono.
TAPI llama al método AddRef en la interfaz ITAddress devuelta por ITPhone::get_Addresses. La aplicación debe llamar a Release en la interfaz ITAddress para liberar recursos asociados a él.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tapi3if.h (incluya Tapi3.h) |
| Library | Uuid.lib |
| Archivo DLL | Tapi3.dll |