cciGetNodeType

Esta función devuelve el tipo del nodo especificado.

Sintaxis

CciSize  cciGetNodeType (int*                    returnCode,
                                        CciNode*          node,
                                        CciChar*          value,
                                        CciSize         length);

Parámetros

returnCode (salida)
Recibe el código de retorno de la función (salida).
  • CCI_INV_BUFFER_TOO_SMALL

    El almacenamiento intermedio proporcionado no es lo suficientemente grande para contener el valor del tipo de nodo.

node (entrada)
Este es un manejador para un nodo.
value (salida)
La dirección de un almacenamiento intermedio, asignada por el emisor de la llamada para contener el valor del tipo de nodo.
length
La longitud, en CciChars, del almacenamiento intermedio asignado por el emisor de la llamada.

Valores de retorno

  • Si la ejecución se realiza satisfactoriamente, el tipo del nodo se copia en el almacenamiento intermedio proporcionado y se devuelve el número de caracteres CciChar copiados.
  • Si el tamaño del almacenamiento intermedio no es suficientemente grande para contener el tipo del nodo, returnCode se establece en CCI_BUFFER_TOO_SMALL y se devuelve el número de CciChars necesarios.

Ejemplo

void myPropagatedMessageCallback(
                        CciMessage*  message,
                        CciMessage*    localEnvironment,
                        CciMessage* exceptionList,
                        CciMessage*    environment,
                        CciConnection* connection){
   
	int rc = CCI_SUCCESS;
   CciNode* sourceNode = cciGetSourceNode(&rc,
                                          connection);
   /*debe comprobar ahora el código de retorno de los valores no previstos*/

   CciChar sourceNodeType[initialStringBufferLength];
   sourceNodeTypeLength = cciGetNodeType(&rc,
                                         sourceNode,
                                         sourceNodeType,
                                         initialStringBufferLength);
   /*debe comprobar ahora el código de retorno de los valores no previstos*/
   /*si el código de retorno es CCI_BUFFER_TOO_SMALL cambie el tamaño y vuelva a intentarlo*/
Conceptos relacionados
Desarrollo de salidas de usuario
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
as36000_