dsmEndTxnEx

Parámetros

dsmEndTxnExIn_t *dsmEndTxnExInP (I)

Esta estructura contiene los siguientes parámetros:

dsmHandle

El descriptor de contexto que identifica la sesión y la asocia a las llamadas posteriores de IBM® Storage Protect .

dsUint8_t vote (I)

Indica si el cliente de aplicaciones confirma o no todas las acciones realizadas entre la llamada dsmBeginTxn anterior y esta llamada. Los valores posibles son:

   DSM_VOTE_COMMIT     /* commit current transaction    */
   DSM_VOTE_ABORT      /* roll back current transaction */

Utilice DSM_VOTE_ABORT únicamente si la aplicación tiene un motivo para detener la transacción.

dsmEndTxnExOut_t *dsmEndTxnExOutP (O)

Esta estructura contiene los siguientes parámetros:

dsUint16_t *reason (O)

Si la llamada a dsmEndTxnEx finaliza con un error o el valor de vote no está de acuerdo, este parámetro tiene un código de motivo que indica por qué el voto ha fallado.

Sugerencia: El código de retorno para la llamada puede ser cero y el código de razón puede ser distinto de cero. Por lo tanto, el cliente de aplicación debe siempre comprobar los errores tanto en el código de retorno como en el código de motivo (if (rc || reason)) antes de dar por hecho de que la operación ha finalizado correctamente.

Si la aplicación especifica un voto de DSM_VOTE_ABORT, el código de motivo es DSM_RS_ABORT_BY_CLIENT (3). Consulte Archivo de origen de códigos de retorno de API: dsmrc.h para obtener una lista de los posibles códigos de razón. Los números del 1 al 50 de la lista de códigos de retorno están reservados para los códigos de motivo. Si el servidor finaliza la transacción, el código de retorno es DSM_RC_CHECK_REASON_CODE. En este caso, el valor de motivo contiene más información sobre la causa de la anulación.

groupLeaderObjId

El ID del objeto líder del grupo que se devuelve cuando se utiliza el indicador DSM_ACTION_OPEN con la llamada dsmGroupHandler.

Códigos de retorno

Los números de código de retorno se proporcionan entre paréntesis ( ).