Inicio del cambio

cciGetNodeName

Esta función devuelve el nombre de un nodo especificado.

Sintaxis

CciSize getNodeName (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 era lo suficientemente grande para mantener el valor del nombre del nodo.

node (entrada)
Éste es un manejador para un nodo.
value (salida)
Dirección de un almacenamiento intermedio, asignado por el canal de llamada para mantener el valor del nombre del nodo.
length
Longitud, en CciChars, del almacenamiento intermedio asignado por el canal de llamada.

Valores de retorno

  • Si se realiza satisfactoriamente, el nombre de 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 nombre 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* targetNode = cciGetTargetNode(&rc,
connection);
CciChar targetNodeName [initialStringBufferLength];
targetNodeNameLength = cciGetNodeName(&rc,
targetNode,
targetNodeName,
initialStringBufferLength);
/*you should now check the rc for unexpected values*/
/*if rc is CCI_BUFFER_TOO_SMALL then you should resize and retry*/
}
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 04/05/2006
as35990_


Fin del cambio