Virtual Devices (3.1) (vdag31qh.hlp) (Table of Contents; Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
Query_Destroy
                                                     Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
include vmm.inc
 
mov     ebx, VM         ; VM handle
mov     eax, Query_Destroy
VMMcall System_Control
 
The Query_Destroy message directs the virtual device to display a warning
message if the destruction of the specified virtual machine will disrupt the
operation of the virtual device. The virtual shell device sends this message
before attempting to destroy a virtual machine that has not terminated
normally.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
VM         Specifies a handle identifying the virtual machine to destroy.
 
Return Value
 
The carry flag is set if the destruction of the virtual machine will disrupt
the virtual device. Otherwise, the carry flag is clear.
 
Comments
 
Virtual devices that set the carry flag must also display a message box,
using the SHELL_Message service to inform the user of the potential problem.
The user can then decide whether to continue destroying the virtual
machine.
 
Uses
 
Flags
 
See Also
 
Destroy_VM, SHELL_Message