FC_Scan - Descripción funcional

Descripción general

Tipo:

Función

Disponible desde:

V1.0.0.0

Hereda de:

Implementa:

Descripción funcional

La función FC_Scan se utiliza para enviar una petición de exploración (difusión) a las interfaces de los dispositivos.

NOTA: La ejecución de esta función afectará a la carga de la red. En función de la carga de la red o de los dispositivos, es posible que los dispositivos conectados tarden algún tiempo en enviar su respuesta.

La petición de exploración utiliza protocolos diferentes.

NOTA:
  • La base de datos interna está limitada a 500 entradas, lo que significa que solo pueden direccionarse 500 dispositivos con FC_GetPeerScanData o FB_SendCommand/FB_ExtendedSendCommand.

  • La base de datos interna se va llenando en el orden en que se reciben las respuestas.

  • Es posible que un dispositivo conectado no figure en la base de datos interna (por ejemplo, si el dispositivo no es compatible con el protocolo seleccionado).

  • Tras una nueva exploración de la red, espere de 1 a 5 s (en función del número de dispositivos conectados) antes de usar los datos de FC_GetPeerScan.

  • Ejecute FC_ClearScanList antes de actualizar la base de datos interna con FC_Scan, ya que, de lo contrario, puede obtener datos obsoletos, como por ejemplo cuando un dispositivo ya no está conectado pero aún figura en la base de datos interna.

  • Utilice la función FC_Scan después de modificar la configuración mediante FB_SendCommand/FB_ExtendedSendCommand para actualizar los datos de los dispositivos conectados en la base de datos interna (por ejemplo, al establecer una nueva configuración de IP).

  • Si hay dispositivos de terceros que responden al mensaje de difusión, estos se añadirán a la base de datos interna.

Interfaz

Salida

Tipo de datos

Descripción

q_etResult

ET_Result

Proporciona información de diagnóstico y estado en forma de valor numérico.

q_sResultMsg

STRING[80]

Proporciona información adicional de diagnóstico y estado en forma de mensaje de texto.

Valor de retorno

Tipo de datos

Descripción

BOOL

TRUE: La función se ha ejecutado correctamente.

FALSE: Consulte la información de diagnóstico.