_DOSMGR_Set_Exec_VM_Data

include dosmgr.inc
 
VxDcall _DOSMGR_Set_Exec_VM_Data, <VM, CommTail, PRGName, InitDrvDir>
 

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 because it does not simulate calls or interrupts into the virtual machine; it just sets instance data.

• No return value.

VM

Handle of the virtual machine to set execution data for.

CommTail

Address of the command tail for the execution. The tail can be up to 128 bytes. The first byte must specify the number of bytes in the tail; the last byte must be 0Dh.

PRGName

Address of a null-terminated string specifying the name of the program to execute.

InitDrvDir

Address of 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 characters, 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.

This service must be called before calling the _DOSMGR_Exec_VM service.