Inicio del cambio

cciRegisterUserExit

Esta es una función de programa de utilidad que el código de usuario puede llamar durante la invocación de bipInitializeUserExits. El código de usuario la invoca si el usuario desea registrar funciones para que se invoquen cada vez que se produzcan determinados sucesos.

Sintaxis

typedef struct cci_UEVft {
int reserved;
char StrucId[4];
int Version;
cciInputMessageCallback iFpInputMessageCallback;
cciTransactionEventCallback iFpTransactionEventCallback;
cciPropagatedMessageCallback iFpPropagatedMessageCallback;
cciNodeCompletionCallback iFpNodeCompletionCallback;
} CCI_UE_VFT;
void cciRegisterUserExit (
int*                returnCode,
CciChar* name,
CciDataContext* userContext,
CCI_UE_VFT* functionTable);

Parámetros

returnCode (salida)
Necesita el código de retorno de la función. Los valores posibles son:
  • CCI_DUP_USER_EXIT_NAME

    El nombre especificado coincide con el nombre de una rutina de salida de usuario que se ha registrado anteriormente en el grupo de ejecución actual.

  • CCI_INV_USER_EXIT_NAME

    El nombre especificado no es válido. Esto puede deberse a que se ha especificado un puntero NULO, una serie de caracteres vacía o una serie de caracteres que contiene caracteres no alfanuméricos.

Name (entrada)
Debe contener un puntero a una serie de caracteres CciChars terminada en nulo que especifique un nombre para la rutina de salida de usuario. El nombre debe ser único en todas las rutinas de salida de usuario que pueden instalarse en el mismo intermediario. Este nombre se utiliza para identificar la rutina de salida de usuario en, por ejemplo:
  • Mensajes de rastreo de usuario
  • Mensajes de excepción o anotaciones cronológicas del sistema
  • Mandatos de administración (por ejemplo, mqsichangeflowuserexit)
El nombre tiene las restricciones siguientes:
  • Sólo debe contener caracteres alfanuméricos.
  • No puede contener más de 255 caracteres.
  • El nombre debe ser único en todas las rutinas de salida de usuario que pueden instalarse en el mismo intermediario.
userContext (entrada)
Permite al canal de llamada proporcionar un puntero de contexto que, cuando se llama, se pasa a la función de devolución de llamada. Este parámetro puede ser NULL.
functionTable (entrada)
Este es un puntero a una estructura con campos que deben contener punteros a funciones que coincidan con las firmas correctas o contener NULO. Un valor NULO para cualquiera de estos campos indica que la rutina de salida de usuario no debe invocarse para dicho suceso.

Valores de retorno

Ninguno. Si se produce un error, el parámetro returnCode indica la razón del mismo.

Ejemplo

extern "C"{
void bipInitializeUserExits(){
int          rc = CCI_SUCCESS;
CCI_UE_VFT myVft = {CCI_UE_VFT_DEFAULT};
myVft.iFpInputMessageCallback = myInputMessageCallback;
myVft.iFpTransactionEventCallback = myTransactionEventCallback;
myVft.iFpPropagatedMessageCallback = myPropagatedMessageCallback;
myVft.iFpNodeCompletionCallback = myNodeCompletionCallback;
cciRegisterUserExit(&rc,
MyConstants::myUserExitName,
0,
&myVft);
/*you should now check the rc for unexpected values*/
return;
}
}/*end of extern "C" */
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 04/05/2006
as35920_


Fin del cambio