cniSqlCreateStatement

Esta función crea un objeto de expresión SQL que representa la sentencia especificada por el argumento de sentencia, utilizando la sintaxis definida para el nodo de proceso de flujo de mensajes Compute. Esta función devuelve un puntero al objeto de expresión SQL, que se utiliza como entrada a las funciones que ejecutan la sentencia, es decir cniSqlExecute y cniSqlSelect. El usuario puede crear varios objetos de expresión SQL en un solo nodo de proceso de flujo de mensajes. Aunque estos objetos pueden crearse en cualquier momento, normalmente los deberá crear cuando se creen las instancias del nodo de proceso de flujo de mensajes, en la función de implementación cniCreateNodeContext.

Sintaxis

CciSqlExpression* cniSqlCreateStatement(
  int*               returnCode,
  CciNode*           nodeObject,
  CciChar*           dataSourceName,
  CciSqlTransaction  transaction,
  CciChar*           statement);

Parámetros

returnCode
Código de retorno de la función (salida).
nodeObject
Nodo de proceso de flujo de mensajes que es propietario del objeto de expresión SQL (entrada). Este puntero se pasa a la función de implementación cniCreateNodeContext.
dataSourceName
Nombre de origen de datos ODBC (Open Database Connectivity) utilizado si la sentencia hace referencia a los datos de una base de datos externa (entrada).
transaction
Especifica si se realiza una confirmación de base de datos después de ejecutar la sentencia (entrada). Los valores válidos son:
CCI_SQL_TRANSACTION_AUTO
Especifica que una confirmación de base de datos se realiza al completarse el flujo de mensajes (es decir, como una transacción coordinada completamente a nivel global, o coordinada parcialmente a nivel global). Éste es el valor por omisión.
CCI_SQL_TRANSACTION_COMMIT
Especifica que una confirmación se realiza después de ejecutarse la sentencia, y dentro de la función cniSqlExecute o cniSqlSelect (es decir, el flujo de mensajes lo coordina parcialmente el intermediario).
statement
Expresión SQL que se va a crear, utilizando la sintaxis definida para el nodo de proceso de flujo de mensajes Compute (entrada).

Valores de retorno

Si la función se ejecuta correctamente, se devuelve la dirección del objeto de expresión SQL. Si se produce un error, se devuelve cero (CCI_NULL_ADDR), y el parámetro returnCode indica la causa de dicho error.

Conceptos relacionados
Nodos de proceso de mensajes definidos por el usuario
Nodos de salida definidos por el usuario

Tareas relacionadas
Creación de un nodo de proceso de mensajes en C

Referencia relacionada
Funciones de programa de utilidad de nodo de lenguaje C
cniCreateNodeContext
cniSqlDeleteStatement
cniSqlExecute
cniSqlSelect