Description

The following table displays the documentation for the 'CallbackInvoke' API in all languages currently available:

Language

Documentation

English (United States)

Invoke specific callback of a method, after MethodInvokeAllow and before MethodInvokeCommit API call (callbacks which are not invoked by specific CallbackInvoke calls are invoked automatically upon MethodInvokeCommit's call)

Español (moderno)

Acciona un callback específico de un método, entre las llamadas de las APIs MethodInvokeAllow y MethodInvokeCommit (callbacks no accionados por llamadas específicas de CallbackInvoke son accionados automáticamente por la llamada de MethodInvokeCommit)

Português (Brasil)

Aciona um callback específico de um método, entre as chamadas das APIs MethodInvokeAllow e MethodInvokeCommit (callbacks não acionados por chamadas de CallbackInvoke são acionados automaticamente no momento da chamada de MethodInvokeCommit)

Parameters

The following table describes all of 'CallbackInvoke''s parameters, in every language available.

ID

Name

Language

Description

Type

Min-Max Length

Reentr Key Member

Optional

1

MethodInvokeAllow

English (United States)

Operation handle returned from succesful call of MethodInvokeAllow

operationhandle

48-48

No

No

2

CallbackName

English (United States)

Name of callback to be invoked (always a standard callback; rollback callbacks cannot be invoked explicitly)

callback

6-64

No

No

3

Rollback

English (United States)

Type of callback to be called - exists only for logging purposes (parameter value gets ignored by implementation)

boolean

4-5

No

Yes

1

MethodInvokeAllow

Español (moderno)

Protocolo de operación obtenido de llamada exitosa a MethodInvokeAllow

operationhandle

48-48

No

No

2

CallbackName

Español (moderno)

Nombre del callback a ser accionado (siempre un callback stándard; callbacks de rollback no pueden ser ejecutados explícitamente)

callback

6-64

No

No

3

Rollback

Español (moderno)

Tipo de callback a ser llamado - existe apenas para finalidad de registro de las llamadas (valor del parámetro es ignorado por la implementación)

boolean

4-5

No

Yes

1

MethodInvokeAllow

Português (Brasil)

Protocolo de operação retornado por chamada bem sucedida a MethodInvokeAllow

operationhandle

48-48

No

No

2

CallbackName

Português (Brasil)

Nome do callback a ser acionado (sempre um callback normal; callbacks de rollback não podem ser acionados explicitamente)

callback

6-64

No

No

3

Rollback

Português (Brasil)

Tipo de callback a ser chamado - existe apenas para fins de registro das chamadas (valor do parâmetro é ignorado pela implementação)

boolean

4-5

No

Yes

Return Value

'CallbackInvoke' returns a value of type operationHandle (minimum length of returned values is 48 characters characters, while maximum length of returned values is 48 characters characters).

Please note that all APIs returning values of types that allow for localized values (like e.g. boolean or country) always return the standard type values.

Specific Error Codes

If an error happens during the execution of any VersaCloud call, an errorcode is returned instead of the standard return value described above.

The following table lists errorcodes returned specifically by the 'CallbackInvoke' API (generic errorcodes like wrong number of parameters or invalid values for parameters' types are not listed):

Errorcode

Language

Description

:@Err#Api0000033

English (United States)

Operation handle was not returned by a previous corresponding and still pending MethodInvokeAllow call

:@Err#Cbk0000012

English (United States)

Value provided as callback name is not associated to specified method

:@Err#Cbk0000053

English (United States)

Remote SQL Server stored procedure call generated an error instead of returning a value

:@Err#Cbk0000603

English (United States)

CallbackInvoke cannot be called to run a standard callback once the transaction has entered rollback state

:@Err#Cbk0000604

English (United States)

CallbackInvoke cannot be called to run a rollback callback before the transaction has entered rollback state

:@Err#Cbk0000614

English (United States)

CallbackInvoke received a return value from the callback connector which is not compatible with the return type defined for the callback

:@Err#Cbk0000999

English (United States)

Value provided as callback invocation protocol has not been implemented

:@Err#Api0000033

Español (moderno)

Protocolo de operación no fue obtenido por uma llamada anterior a MethodInvokeAllow que aún está pendiente

:@Err#Cbk0000012

Español (moderno)

Valor informado como nuevo nombre de callback no está asociado al método especificado

:@Err#Cbk0000053

Español (moderno)

La llamada de la stored procedure remota en un servidor SQL generó un error en vez de retornar un valor

:@Err#Cbk0000603

Español (moderno)

CallbackInvoke no puede ser llamado para accionar un callback normal después que la transacción haya entrado en estado de rollback

:@Err#Cbk0000604

Español (moderno)

CallbackInvoke no puede ser llamado para accionar un callback de rollback antes de que la transacción haya entrado en estado de rollback

:@Err#Cbk0000614

Español (moderno)

CallbackInvoke recibió un valor de retorno del conector de callback que no es compatible con el tipo de retorno definido para el callback

:@Err#Cbk0000999

Español (moderno)

Valor informado como protocolo de llamada callback no está implementado

:@Err#Api0000033

Português (Brasil)

Protocolo de operação não foi retornado por uma chamada prévia a MethodInvokeAllow que ainda está pendente

:@Err#Cbk0000012

Português (Brasil)

Valor fornecido como nome de callback não está associado com o método especificado

:@Err#Cbk0000053

Português (Brasil)

A chamada da stored procedure remota num servidor SQL gerou um erro em vez de retornar um valor

:@Err#Cbk0000603

Português (Brasil)

CallbackInvoke não pode ser chamado para acionar um callback normal após a transação haver entrado em estado de rollback

:@Err#Cbk0000604

Português (Brasil)

CallbackInvoke não pode ser chamado para acionar um callback de rollback antes de que a transação haja entrado em estado de rollback

:@Err#Cbk0000614

Português (Brasil)

CallbackInvoke recebeu um valor de retorno do conector de callback que não é compatível com o tipo de retorno definido para o callback

:@Err#Cbk0000999

Português (Brasil)

Valor fornecido como protocolo de chamada de callback não está implementado

US Patent Requested