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.
_DOSMGR_Set_Exec_VM_Data
                                                     Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
include dosmgr.inc
 
VxDcall _DOSMGR_Set_Exec_VM_Data, <VM, CommTail, PRGName, InitDrvDir>
 
The _DOSMGR_Set_Exec_VM_Data service sets the data for the initial execution
into a virtual machine. It is reserved for exclusive use by the virtual
shell device.
 
This service can be called during the Create_VM message since it does not
simulate calls or interrupts into the virtual machine; it just sets instance
data.
 
Parameter   Description
────────────────────────────────────────────────────────────────────────────
 
VM          Specifies the handle of the virtual machine_Handle to set
            execution data for.
 
CommTail    Points to the command tail for the execution. The tail can be up
            to 128 byte. The first byte must specify the number of bytes in
            the tail; the last byte must be 0Dh.
 
PRGName     Points to null-terminated string specifying the name of the
            program to execute.
 
InitDrvDir  Points to a null-terminated string specifying the initial
            directory and drive for the virtual machine. The drive letter
            must be a capital letter. The string must be less than or equal
            to 64 chars including null terminator.
 
            If this parameter is zero, the service does not set the default
            directory. This form of the service is made by the
            DOSMGR_Exec_VM service. Other virtual devices should not use
            this form.
 
Return Value
 
This service has no return value.
 
Comments
 
This service must be called before calling the _DOSMGR_Exec_VM service.
 
See Also
 
_DOSMGR_Exec_VM