Terminates a known virtual machine.
#include <nks/vm.h> int NXVmDestroy ( NXVmId_t id);
(IN) Specifies the virtual machine or application to terminate.
If successful, returns 0; otherwise, returns a nonzero error code:
NXVmDestroy marks the specified virtual machine (and application running in it) for destruction. The actual destruction can occur sometime in the future, but it is not guaranteed.
The id parameter is the identity created from NXVmSpawn. It is not the same as an NLMâ„¢ handle. Only the creator can legally terminate a virtual machine.
If the targeted application cooperates badly, termination might occur badly or not at all. However, the fact that the identity of the target cannot be known without its cooperation limits perniciousness.