cpiCreateContext

Finalidad

Esta función crea un contexto de extensión definido por el usuario, asociado con un objeto de analizador. La invoca el intermediario de mensajes al construirse o asignarse una instancia de un objeto de analizador. Esto ocurre 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 adecuada de los datos de mensaje. Antes de invocar esta función, el intermediario habrá creado un elemento de nombre como elemento raíz efectivo para el analizador. No obstante, este elemento no recibirá ningún nombre. El analizador debe denominar este elemento en la función cpiSetElementName.

Las responsabilidades de la extensión son las siguientes:
  1. Asignar las áreas de datos específicas de una instancia de analizador (como el contexto) que puedan ser necesarias.
  2. Realizar la adquisición o inicialización adicional de recursos que pueda ser necesaria.
  3. Devolver la dirección del contexto a la función de llamada. Siempre que se invoca una función de implementación de plug-in para esta instancia de analizador, se pasa el contexto apropiado, como un argumento, a esa función. Esto significa que un analizador de plug-ins desarrollado en C no necesita mantener sus propios punteros estáticos por área de datos de instancia.
Definida en Tipo Miembro
CPI_VFT Obligatoria iFpCreateContext

Sintaxis

void cpiCreateContext(
  CciParser*   parser);

Parámetros

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

Valores de retorno

Si la función se ejecuta correctamente, se devuelve la dirección del contexto de extensión definido por el usuario. De lo contrario, se devuelve el valor cero.

Conceptos relacionados
Analizadores definidos por el usuario
Extensiones definidas por el usuario

Referencia relacionada
Funciones de implementación de analizador