Método ITAddress2::get_Phones (tapi3if.h)
El método get_Phones devuelve un puntero VARIANT a una ITCollection de objetos de teléfono correspondientes a los dispositivos telefónicos que se pueden usar con esta dirección.
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 EnumeratePhones .
Sintaxis
HRESULT get_Phones(
[out] VARIANT *pPhones
);
Parámetros
[out] pPhones
Puntero a una VARIANTE que contiene una ITCollection de punteros de interfaz itPhone .
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 a través de phoneGetID con la clase de dispositivo tapi/line. Si no hay teléfonos disponibles para su uso con la dirección , este método genera una colección vacía y devuelve S_OK.
TAPI llama al método AddRef en la interfaz itPhone devuelta por ITAddress2::get_Phones. La aplicación debe llamar a Release en la interfaz de ITPhone 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 |