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

Consulte también

IEnumTerminal

ITAddress

ITPhone