cniSqlCreateStatement

Inicio del cambioCrea 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, aunque usted no podrá utilizar:
  • CREATE PROCEDURE
  • CREATE MODULE
  • CREATE SCHEMA
  • CREATE FUNCTION
Esta función devuelve un puntero al objeto de expresión SQL, que se utiliza como entrada en las funciones que ejecutan la sentencia, es decir cniSqlExecute y cniSqlSelect. Puede crear varios objetos de expresión SQL en un solo nodo de proceso de flujo de mensajes. Aunque estos objetos se pueden crear en cualquier momento, normalmente los deberá crear al crear la instancia del nodo de proceso de flujo de mensajes, dentro de la función de implementación cniCreateNodeContext.Fin del cambio

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).
Los códigos de retorno posibles son:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_NODE_OBJECT
  • CCI_INV_TRANSACTION_TYPE
  • CCI_INV_STATEMENT
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 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 que se ejecute la sentencia (entrada). Los valores válidos son:
CCI_SQL_TRANSACTION_AUTO
Especifica que se realice una confirmación de base de datos cuando se complete el flujo de mensajes (es decir, como una transacción coordinada globalmente de forma completa o coordinada globalmente de forma parcial). Es el valor por omisión.
CCI_SQL_TRANSACTION_COMMIT
Especifica que se realice una confirmación después de la ejecución de la sentencia y dentro de la función cniSqlExecute o cniSqlSelect (es decir, el flujo de mensajes está parcialmente coordinado por el intermediario).
statement
Expresión SQL que se debe crear, utilizando la sintaxis definida para el nodo de proceso de flujo de mensajes Compute (entrada).

Valores de retorno

Si la ejecución se realiza satisfactoriamente, 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 razón del error.

Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
as08000_