Método ITPhone::EnumerateTerminals (tapi3if.h)
El método EnumerateTerminals recupera una enumeració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 EnumerateTerminals(
[in] ITAddress *pAddress,
[out] IEnumTerminal **ppEnumTerminal
);
Parámetros
[in] pAddress
Puntero a la interfaz ITAddress .
[out] ppEnumTerminal
Puntero a la interfaz IEnumTerminal que enumera los terminales.
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 enumeración vacía y devuelve S_OK.
Aunque la función phoneGetID requiere el identificador para un dispositivo telefónico abierto, la aplicación no tiene que llamar al método ITPhone::Open antes de llamar a EnumerateTerminals. 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 IEnumTerminal devuelta por ITPhone::EnumerateTerminals. La aplicación debe llamar a Release en la interfaz IEnumTerminal para liberar recursos asociados a él.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tapi3if.h (include Tapi3.h) |
| Library | Uuid.lib |
| Archivo DLL | Tapi3.dll |