cniIsTerminalAttached

Comprueba si un terminal está conectado a otro nodo mediante un conector. Devuelve un valor entero que especifica si el objeto de terminal especificado está conectado a uno o varios terminales de otros nodos de flujos de mensajes. Puede utilizar esta función para probar si se puede propagar un mensaje a un terminal. Sin embargo, no es necesario invocar esta función antes de propagar un mensaje con la función de utilidad cniPropagate. Mediante la utilización de la función cniIsTerminalAttached, un nodo puede modificar su comportamiento cuando un terminal no está conectado.

Sintaxis

int cniIsTerminalAttached(
  int*          returnCode,
  CciTerminal*  terminalObject);

Parámetros

returnCode
Código de retorno de la función (salida).
Los códigos de retorno posibles son:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_TERMINAL_OBJECT
terminalObject
Dirección del terminal de entrada o salida en el que se debe comprobar si hay conectado un conector (entrada). La dirección se devuelve de cniCreateOutputTerminal.

Valores de retorno

  • Si el terminal está conectado a otro nodo mediante un conector, se devuelve un valor de 1.
  • Si el terminal no está conectado o se ha producido una anomalía, se devuelve un valor de cero.
  • Si se ha producido una anomalía, el valor del parámetro returnCode indica la razón del error.

Ejemplo

  if (terminalObject) {
    if (cniIsTerminalAttached(&rc, terminalObject)) {
      if (rc == CCI_SUCCESS) {
        retvalue = cniPropagate(
                                &rc, 
                                terminalObject, 
                                destinationList, 
                                exceptionList, 
                                message);
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
as07550_