cpiCreateContext

Finalidad

Crea un contexto de extensión definida por el usuario asociado con un objeto de analizador. La invoca el intermediario de mensajes cuando se construye o se asigna una instancia de un objeto de analizador. Esto se produce cuando un flujo de mensajes hace que se analicen los datos de mensaje; el intermediario construye o asigna un objeto de analizador para adquirir la sección apropiada de los datos de mensaje. Antes de se invoque esta función, el intermediario habrá creado un elemento de nombre como elemento raíz efectivo para el analizador. Sin embargo, este elemento no tiene nombre. El analizador deberá dar un nombre a este elemento en la función cpiSetElementName.

Las responsabilidades de la extensión son:
  1. Asignar las áreas de datos específicas de instancia de analizador (por ejemplo contexto) que puedan ser necesarias.
  2. Realizar la adquisición o inicialización de recursos adicionales que puedan ser necesarios.
  3. Devolver la dirección del contexto a la función de invocación. Siempre que se invoca una función de implementación para esta instancia de analizador, el contexto apropiado se pasa como argumento a dicha función. Esto significa que un analizador definido por el usuario desarrollado en C no necesita mantener sus propios punteros estáticos a áreas de datos por instancia.
Definida en Tipo Miembro
CPI_VFT Obligatorio iFpCreateContext

Sintaxis

void cpiCreateContext(
  CciParser*   parser);

Parámetros

parser
Dirección del objeto de analizador (entrada).

Valores de retorno

Si la ejecución se realiza satisfactoriamente, se devuelve la dirección del contexto de extensión definida por el usuario. De lo contrario, se devuelve un valor de cero.

Conceptos relacionados
Analizadores definidos por el usuario
Extensiones definidas por el usuario
Referencia relacionada
Funciones de implementación de analizador en C
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
as08095_