cniRootElement

Obtiene el elemento de sintaxis raíz asociado con un mensaje específico. Devuelve el elemento raíz que está asociado con (y es propiedad de) el objeto de mensaje identificado por el parámetro message. Cuando el intermediario crea un objeto de mensaje, se crea automáticamente un elemento raíz.

Sintaxis

CciElement* cniRootElement(
  int*         returnCode,
  CciMessage*  message);

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_MESSAGE_OBJECT
message
Dirección del objeto de mensaje (entrada).

Valores de retorno

Si la ejecución se realiza satisfactoriamente, se devuelve la dirección del objeto de elemento raíz. De lo contrario, se devuelve cero (CCI_NULL_ADDR) y el parámetro returnCode indica la razón del error.

Ejemplo

   inRootElement = cniRootElement(&rc, message);
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
as07680_