Método ITPhone::get_Terminals (tapi3if.h)
El método get_Terminals recupera una colección de terminales asociados al teléfono. La aplicación no tiene que llamar a ITPhone::Open antes de ejecutar este método.
Sintaxis
HRESULT get_Terminals(
[in] ITAddress *pAddress,
[out] VARIANT *pTerminals
);
Parámetros
[in] pAddress
Puntero a la interfaz ITAddress .
[out] pTerminals
Puntero a una VARIANTE que contiene una ITCollection de punteros de interfaz ITTerminal .
Valor devuelto
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
Si no hay terminales asociados con el teléfono, este método genera una colección vacía y devuelve S_OK.
La aplicación no tiene que llamar al método ITPhone::Open antes de llamar a get_Terminals. 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_Terminals. La aplicación debe llamar a Release en la interfaz ITAddress para liberar recursos asociados a él.
Requisitos
| Plataforma de destino | Windows |
| Encabezado | tapi3if.h (include Tapi3.h) |
| Library | Uuid.lib |
| Archivo DLL | Tapi3.dll |