Inicio del cambio

cciGetNodeAttribute

Esta función devuelve el valor de un atributo especificado.

Sintaxis

CciSize cciGetNodeAttribute (int* returnCode,
CciNode* node,
CciChar* name,
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 era lo suficientemente grande para mantener el valor del tipo del nodo.

node (entrada)
Éste es un manejador para un nodo.
name (entrada)
Éste es un puntero a una serie de caracteres CciChar terminada en nulo que especifica el nombre del atributo de nodo que se está consultando.
value (salida)
Dirección de un almacenamiento intermedio, asignado por el canal de llamada para mantener el valor del atributo.
length
Longitud, en CciChars, del almacenamiento intermedio asignado por el canal de llamada.

Valores de retorno

  • Si la ejecución se realiza satisfactoriamente, el valor de atributo 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 valor del atributo, returnCode se establece en CCI_BUFFER_TOO_SMALL y se devuelve el número de CciChars necesarios.
  • Si name especifica un nombre de atributo que no es apropiado para el nodo en cuestión, returnCode se establece en CCI_ATTRIBUTE_UNKOWN.

Ejemplo

void myPropagatedMessageCallback(
CciMessage*        message,
CciMessage* localEnvironment,
CciMessage*        exceptionList,
CciMessage* environment,
CciConnection* connection){
int          rc = CCI_SUCCESS;
CciNode* sourceNode = cciGetSourceNode(&rc,
connection);
/*you should now check the rc for unexpected values*/
CciChar queueNameAttribute[16];
cciMbsToUcs(&rc,
"queueName",
queueNameAttribute,
  16,
BIP_DEF_COMP_CCSID);
/*you should now check the rc for unexpected values*/
CciChar queueName [512];
sourceNodeQueueNameLength = cciGetNodeType(&rc,
sourceNode,
queueName,
512);
/*you should now check the rc for unexpected values*/
/*if rc is CCI_BUFFER_TOO_SMALL then you should resize and retry*/
/*sourceNodeQueueNameLength will hold the actual or required size */
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 04/05/2006
as36010_


Fin del cambio