Salesforce

CtxKill (Magic xpa 4.x)

« Go Back

Information

 
Created BySalesforce Service User
Approval Process StatusPublished
Objective
Description

CtxKill (Magic xpa 4.x)

Abruptly closes a context and removes it from the Active Context list. The purpose of this function is to end active contexts waiting for the completion of certain procedures, such as Exit operations, or calling DLLs.

Syntax:

CtxKill (context entry or identifier,kill thread)

Parameters:

context entry or identifier: A number representing the context. This number can either be the context entry number in the current context list or the actual context identifier.

kill thread: Default: False. If this parameter is set to True, contexts are killed even if the thread they are hosting is busy with external resources. Note that if this is set to True, there is a risk to locked resources.

Returns:

True when the specified context is abruptly removed. If the context is not found or you are trying to remove the current context, the function fails and returns False.

Note:

A running context can be removed at any time regardless of its current activity, including synchronous external operations such as the Invoke UDP operation.

The CtxKill function abruptly terminates the running thread of the specified context. Terminating a running thread can result in the improper release of resources, such as database connections and Instantiated Java or COM objects, which is similar to abruptly terminating the engine process.

Before evaluating the CtxKill function, you should load the Context list by evaluating the CtxNum function.

See also:

CtxClose

The Online and Rich Client Samples projects (program ES01 and RES01)

Reference
Attachment 
Attachment