_DOSMGR_Set_Exec_VM_Data

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

Parameters

VM

Specifies the handle of the virtual machine to set execution data for.

CommTail

Points to 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

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 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.

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