common/VBoxGuestLib/VBoxGuestR3LibGuestCtrl.cpp

	VBoxGuestR3LibGuestCtrl.cpp revision a2828f06a7a97fd85445ed5b2c5cb6a12a185d1d
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync/* $Id$ */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync/** @file
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * VBoxGuestR3Lib - Ring-3 Support Library for VirtualBox guest additions, guest control.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync/*
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsync * Copyright (C) 2010-2011 Oracle Corporation
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync *
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * This file is part of VirtualBox Open Source Edition (OSE), as
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * available from http://www.virtualbox.org. This file is free software;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * you can redistribute it and/or modify it under the terms of the GNU
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * General Public License (GPL) as published by the Free Software
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * Foundation, in version 2 as it comes in the "COPYING" file of the
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync *
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * The contents of this file may alternatively be used under the terms
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * of the Common Development and Distribution License Version 1.0
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * (CDDL) only, as it comes in the "COPYING.CDDL" file of the
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * VirtualBox OSE distribution, in which case the provisions of the
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * CDDL are applicable instead of those of the GPL.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync *
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * You may elect to license modified versions of this file under the
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * terms and conditions of either the GPL or the CDDL or both.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync/*******************************************************************************
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync*   Header Files                                                               *
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync*******************************************************************************/
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync#include <iprt/string.h>
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync#include <iprt/mem.h>
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync#include <iprt/assert.h>
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync#include <iprt/cpp/autores.h>
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync#include <iprt/stdarg.h>
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync#include <VBox/log.h>
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync#include <VBox/HostServices/GuestControlSvc.h>
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync#include "VBGLR3Internal.h"
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync/*******************************************************************************
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync*   Structures and Typedefs                                                    *
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync*******************************************************************************/
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsyncusing namespace guestControl;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync/**
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * Connects to the guest control service.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync *
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * @returns VBox status code
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * @param   pu32ClientId    Where to put the client id on success. The client id
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync *                          must be passed to all the other calls to the service.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsyncVBGLR3DECL(int) VbglR3GuestCtrlConnect(uint32_t *pu32ClientId)
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync{
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    VBoxGuestHGCMConnectInfo Info;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    Info.result = VERR_WRONG_ORDER;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    Info.Loc.type = VMMDevHGCMLoc_LocalHost_Existing;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    RT_ZERO(Info.Loc.u);
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    strcpy(Info.Loc.u.host.achName, "VBoxGuestControlSvc");
ad27e1d5e48ca41245120c331cc88b50464813cevboxsync    Info.u32ClientID = UINT32_MAX;  /* try make valgrind shut up. */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    int rc = vbglR3DoIOCtl(VBOXGUEST_IOCTL_HGCM_CONNECT, &Info, sizeof(Info));
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    if (RT_SUCCESS(rc))
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    {
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync        rc = Info.result;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync        if (RT_SUCCESS(rc))
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync            *pu32ClientId = Info.u32ClientID;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    }
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    return rc;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync}
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync/**
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * Disconnect from the guest control service.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync *
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * @returns VBox status code.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * @param   u32ClientId     The client id returned by VbglR3GuestCtrlConnect().
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsyncVBGLR3DECL(int) VbglR3GuestCtrlDisconnect(uint32_t u32ClientId)
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync{
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    VBoxGuestHGCMDisconnectInfo Info;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    Info.result = VERR_WRONG_ORDER;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    Info.u32ClientID = u32ClientId;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    int rc = vbglR3DoIOCtl(VBOXGUEST_IOCTL_HGCM_DISCONNECT, &Info, sizeof(Info));
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    if (RT_SUCCESS(rc))
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync        rc = Info.result;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    return rc;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync}
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync/**
9d4498106267e3834edc3a37bca5ca660153525cvboxsync * Waits until a new host message arrives.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * This will block until a message becomes available.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync *
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * @returns VBox status code.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * @param   u32ClientId     The client id returned by VbglR3GuestCtrlConnect().
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * @param   puMsg           Where to store the message id.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * @param   puNumParms      Where to store the number  of parameters which will be received
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync *                          in a second call to the host.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync */
9d4498106267e3834edc3a37bca5ca660153525cvboxsyncVBGLR3DECL(int) VbglR3GuestCtrlWaitForHostMsg(uint32_t u32ClientId, uint32_t *puMsg, uint32_t *puNumParms)
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync{
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    AssertPtrReturn(puMsg, VERR_INVALID_PARAMETER);
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    AssertPtrReturn(puNumParms, VERR_INVALID_PARAMETER);
5d69af51557e9e9db029ecd243e820383af49b18vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    VBoxGuestCtrlHGCMMsgType Msg;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsync    Msg.hdr.result      = VERR_WRONG_ORDER;
ed24120b1d8a2eddf4291a9654cf45b2372135abvboxsync    Msg.hdr.u32ClientID = u32ClientId;
ed24120b1d8a2eddf4291a9654cf45b2372135abvboxsync    Msg.hdr.u32Function = GUEST_GET_HOST_MSG; /* Tell the host we want our next command. */
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsync    Msg.hdr.cParms      = 2;                  /* Just peek for the next message! */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    VbglHGCMParmUInt32Set(&Msg.msg, 0);
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    VbglHGCMParmUInt32Set(&Msg.num_parms, 0);
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ed24120b1d8a2eddf4291a9654cf45b2372135abvboxsync    int rc = vbglR3DoIOCtl(VBOXGUEST_IOCTL_HGCM_CALL(sizeof(Msg)), &Msg, sizeof(Msg));
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    if (RT_SUCCESS(rc))
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    {
5d69af51557e9e9db029ecd243e820383af49b18vboxsync        rc = VbglHGCMParmUInt32Get(&Msg.msg, puMsg);
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync        if (RT_SUCCESS(rc))
5d69af51557e9e9db029ecd243e820383af49b18vboxsync            rc = VbglHGCMParmUInt32Get(&Msg.num_parms, puNumParms);
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync            if (RT_SUCCESS(rc))
ed24120b1d8a2eddf4291a9654cf45b2372135abvboxsync                rc = Msg.hdr.result;
5d69af51557e9e9db029ecd243e820383af49b18vboxsync                /* Ok, so now we know what message type and how much parameters there are. */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    }
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    return rc;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync}
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
4d8251400411b4dcf2c86b5b0376a326ff45938cvboxsync/**
4d8251400411b4dcf2c86b5b0376a326ff45938cvboxsync * Asks the host to cancel (release) all pending waits which were deferred.
4d8251400411b4dcf2c86b5b0376a326ff45938cvboxsync *
4d8251400411b4dcf2c86b5b0376a326ff45938cvboxsync * @returns VBox status code.
4d8251400411b4dcf2c86b5b0376a326ff45938cvboxsync * @param   u32ClientId     The client id returned by VbglR3GuestCtrlConnect().
4d8251400411b4dcf2c86b5b0376a326ff45938cvboxsync */
4d8251400411b4dcf2c86b5b0376a326ff45938cvboxsyncVBGLR3DECL(int) VbglR3GuestCtrlCancelPendingWaits(uint32_t u32ClientId)
4d8251400411b4dcf2c86b5b0376a326ff45938cvboxsync{
4d8251400411b4dcf2c86b5b0376a326ff45938cvboxsync    VBoxGuestCtrlHGCMMsgCancelPendingWaits Msg;
4d8251400411b4dcf2c86b5b0376a326ff45938cvboxsync
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsync    Msg.hdr.result      = VERR_WRONG_ORDER;
4d8251400411b4dcf2c86b5b0376a326ff45938cvboxsync    Msg.hdr.u32ClientID = u32ClientId;
4d8251400411b4dcf2c86b5b0376a326ff45938cvboxsync    Msg.hdr.u32Function = GUEST_CANCEL_PENDING_WAITS;
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsync    Msg.hdr.cParms      = 0;
4d8251400411b4dcf2c86b5b0376a326ff45938cvboxsync
4d8251400411b4dcf2c86b5b0376a326ff45938cvboxsync    int rc = vbglR3DoIOCtl(VBOXGUEST_IOCTL_HGCM_CALL(sizeof(Msg)), &Msg, sizeof(Msg));
4d8251400411b4dcf2c86b5b0376a326ff45938cvboxsync    if (RT_SUCCESS(rc))
4d8251400411b4dcf2c86b5b0376a326ff45938cvboxsync    {
4d8251400411b4dcf2c86b5b0376a326ff45938cvboxsync        int rc2 = Msg.hdr.result;
4d8251400411b4dcf2c86b5b0376a326ff45938cvboxsync        if (RT_FAILURE(rc2))
4d8251400411b4dcf2c86b5b0376a326ff45938cvboxsync            rc = rc2;
4d8251400411b4dcf2c86b5b0376a326ff45938cvboxsync    }
4d8251400411b4dcf2c86b5b0376a326ff45938cvboxsync    return rc;
4d8251400411b4dcf2c86b5b0376a326ff45938cvboxsync}
4d8251400411b4dcf2c86b5b0376a326ff45938cvboxsync
4d8251400411b4dcf2c86b5b0376a326ff45938cvboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync/**
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * Allocates and gets host data, based on the message id.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync *
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * This will block until data becomes available.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync *
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * @returns VBox status code.
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync * @param   u32ClientId     The client id returned by VbglR3GuestCtrlConnect().
468c2bcb36eb9a032f5dd0fcb34db10bd58e9996vboxsync * @param   uNumParms
de210ca38246009981a22de928a52566c8c53970vboxsync ** @todo Docs!
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync */
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsyncVBGLR3DECL(int) VbglR3GuestCtrlExecGetHostCmdExec(uint32_t  u32ClientId,    uint32_t  cParms,
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsync                                                  uint32_t *puContext,
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsync                                                  char     *pszCmd,         uint32_t  cbCmd,
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsync                                                  uint32_t *puFlags,
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsync                                                  char     *pszArgs,        uint32_t  cbArgs,   uint32_t *pcArgs,
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsync                                                  char     *pszEnv,         uint32_t *pcbEnv,   uint32_t *pcEnvVars,
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsync                                                  char     *pszUser,        uint32_t  cbUser,
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsync                                                  char     *pszPassword,    uint32_t  cbPassword,
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsync                                                  uint32_t *pcMsTimeLimit)
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync{
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    AssertPtrReturn(puContext, VERR_INVALID_PARAMETER);
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    AssertPtrReturn(pszCmd, VERR_INVALID_PARAMETER);
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    AssertPtrReturn(puFlags, VERR_INVALID_PARAMETER);
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    AssertPtrReturn(pszArgs, VERR_INVALID_PARAMETER);
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsync    AssertPtrReturn(pcArgs, VERR_INVALID_PARAMETER);
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    AssertPtrReturn(pszEnv, VERR_INVALID_PARAMETER);
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    AssertPtrReturn(pcbEnv, VERR_INVALID_PARAMETER);
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsync    AssertPtrReturn(pcEnvVars, VERR_INVALID_PARAMETER);
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    AssertPtrReturn(pszUser, VERR_INVALID_PARAMETER);
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    AssertPtrReturn(pszPassword, VERR_INVALID_PARAMETER);
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsync    AssertPtrReturn(pcMsTimeLimit, VERR_INVALID_PARAMETER);
9429e79ee2743cb878d5f3680e2dcad036125e02vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    VBoxGuestCtrlHGCMMsgExecCmd Msg;
468c2bcb36eb9a032f5dd0fcb34db10bd58e9996vboxsync
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsync    Msg.hdr.result      = VERR_WRONG_ORDER;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    Msg.hdr.u32ClientID = u32ClientId;
5d69af51557e9e9db029ecd243e820383af49b18vboxsync    Msg.hdr.u32Function = GUEST_GET_HOST_MSG;
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsync    Msg.hdr.cParms      = cParms; /** @todo r=bird: This isn't safe/right. The parameter count of this HGCM call
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsync                                   * is fixed from our point of view. */
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    VbglHGCMParmUInt32Set(&Msg.context, 0);
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    VbglHGCMParmPtrSet(&Msg.cmd, pszCmd, cbCmd);
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    VbglHGCMParmUInt32Set(&Msg.flags, 0);
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    VbglHGCMParmUInt32Set(&Msg.num_args, 0);
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    VbglHGCMParmPtrSet(&Msg.args, pszArgs, cbArgs);
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    VbglHGCMParmUInt32Set(&Msg.num_env, 0);
9429e79ee2743cb878d5f3680e2dcad036125e02vboxsync    VbglHGCMParmUInt32Set(&Msg.cb_env, 0);
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    VbglHGCMParmPtrSet(&Msg.env, pszEnv, *pcbEnv);
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    VbglHGCMParmPtrSet(&Msg.username, pszUser, cbUser);
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    VbglHGCMParmPtrSet(&Msg.password, pszPassword, cbPassword);
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    VbglHGCMParmUInt32Set(&Msg.timeout, 0);
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    int rc = vbglR3DoIOCtl(VBOXGUEST_IOCTL_HGCM_CALL(sizeof(Msg)), &Msg, sizeof(Msg));
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    if (RT_SUCCESS(rc))
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    {
5d69af51557e9e9db029ecd243e820383af49b18vboxsync        int rc2 = Msg.hdr.result;
5d69af51557e9e9db029ecd243e820383af49b18vboxsync        if (RT_FAILURE(rc2))
5d69af51557e9e9db029ecd243e820383af49b18vboxsync        {
5d69af51557e9e9db029ecd243e820383af49b18vboxsync            rc = rc2;
5d69af51557e9e9db029ecd243e820383af49b18vboxsync        }
5d69af51557e9e9db029ecd243e820383af49b18vboxsync        else
5d69af51557e9e9db029ecd243e820383af49b18vboxsync        {
68e97031354932600728a42c3d454abf04f8c8d1vboxsync            Msg.context.GetUInt32(puContext);
5d69af51557e9e9db029ecd243e820383af49b18vboxsync            Msg.flags.GetUInt32(puFlags);
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsync            Msg.num_args.GetUInt32(pcArgs);
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsync            Msg.num_env.GetUInt32(pcEnvVars);
5d69af51557e9e9db029ecd243e820383af49b18vboxsync            Msg.cb_env.GetUInt32(pcbEnv);
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsync            Msg.timeout.GetUInt32(pcMsTimeLimit);
5d69af51557e9e9db029ecd243e820383af49b18vboxsync        }
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    }
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync    return rc;
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync}
ba8183e1a0c699f5b5131a03e157fc7e39ed3009vboxsync
de210ca38246009981a22de928a52566c8c53970vboxsync
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync/**
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync * Allocates and gets host data, based on the message id.
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync *
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync * This will block until data becomes available.
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync *
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync * @returns VBox status code.
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync * @param   u32ClientId     The client id returned by VbglR3GuestCtrlConnect().
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsync * @param   cParms
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync ** @todo Docs!
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync */
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsyncVBGLR3DECL(int) VbglR3GuestCtrlExecGetHostCmdOutput(uint32_t  u32ClientId,    uint32_t  cParms,
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync                                                    uint32_t *puContext,      uint32_t *puPID,
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync                                                    uint32_t *puHandle,       uint32_t *puFlags)
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync{
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    AssertPtrReturn(puContext, VERR_INVALID_PARAMETER);
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    AssertPtrReturn(puPID, VERR_INVALID_PARAMETER);
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    AssertPtrReturn(puHandle, VERR_INVALID_PARAMETER);
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    AssertPtrReturn(puFlags, VERR_INVALID_PARAMETER);
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync    VBoxGuestCtrlHGCMMsgExecOut Msg;
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync    Msg.hdr.result = VERR_WRONG_ORDER;
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync    Msg.hdr.u32ClientID = u32ClientId;
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync    Msg.hdr.u32Function = GUEST_GET_HOST_MSG;
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsync    Msg.hdr.cParms = cParms;
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    VbglHGCMParmUInt32Set(&Msg.context, 0);
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync    VbglHGCMParmUInt32Set(&Msg.pid, 0);
760446f710619a9daa6cedc7f0601f49e4ea3442vboxsync    VbglHGCMParmUInt32Set(&Msg.handle, 0);
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync    VbglHGCMParmUInt32Set(&Msg.flags, 0);
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync    int rc = vbglR3DoIOCtl(VBOXGUEST_IOCTL_HGCM_CALL(sizeof(Msg)), &Msg, sizeof(Msg));
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync    if (RT_SUCCESS(rc))
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync    {
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync        int rc2 = Msg.hdr.result;
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync        if (RT_FAILURE(rc2))
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync        {
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync            rc = rc2;
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync        }
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync        else
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync        {
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync            Msg.context.GetUInt32(puContext);
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync            Msg.pid.GetUInt32(puPID);
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync            Msg.handle.GetUInt32(puHandle);
760446f710619a9daa6cedc7f0601f49e4ea3442vboxsync            Msg.flags.GetUInt32(puFlags);
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync        }
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync    }
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync    return rc;
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync}
de210ca38246009981a22de928a52566c8c53970vboxsync
de210ca38246009981a22de928a52566c8c53970vboxsync
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync/**
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync * Retrieves the input data from host which then gets sent to the
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync * started process.
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync *
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync * This will block until data becomes available.
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync *
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync * @returns VBox status code.
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync * @param   u32ClientId     The client id returned by VbglR3GuestCtrlConnect().
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsync * @param   cParms
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync ** @todo Docs!
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync */
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsyncVBGLR3DECL(int) VbglR3GuestCtrlExecGetHostCmdInput(uint32_t  u32ClientId,    uint32_t   cParms,
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync                                                   uint32_t *puContext,      uint32_t  *puPID,
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync                                                   uint32_t *puFlags,
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsync                                                   void     *pvData,         uint32_t  cbData,
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync                                                   uint32_t *pcbSize)
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync{
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    AssertPtrReturn(puContext, VERR_INVALID_PARAMETER);
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    AssertPtrReturn(puPID, VERR_INVALID_PARAMETER);
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    AssertPtrReturn(puFlags, VERR_INVALID_PARAMETER);
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    AssertPtrReturn(pvData, VERR_INVALID_PARAMETER);
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    AssertPtrReturn(pcbSize, VERR_INVALID_PARAMETER);
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    VBoxGuestCtrlHGCMMsgExecIn Msg;
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsync    Msg.hdr.result      = VERR_WRONG_ORDER;
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    Msg.hdr.u32ClientID = u32ClientId;
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    Msg.hdr.u32Function = GUEST_GET_HOST_MSG;
a2828f06a7a97fd85445ed5b2c5cb6a12a185d1dvboxsync    Msg.hdr.cParms      = cParms;
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    VbglHGCMParmUInt32Set(&Msg.context, 0);
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    VbglHGCMParmUInt32Set(&Msg.pid, 0);
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    VbglHGCMParmUInt32Set(&Msg.flags, 0);
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    VbglHGCMParmPtrSet(&Msg.data, pvData, cbData);
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    VbglHGCMParmUInt32Set(&Msg.size, 0);
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    int rc = vbglR3DoIOCtl(VBOXGUEST_IOCTL_HGCM_CALL(sizeof(Msg)), &Msg, sizeof(Msg));
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    if (RT_SUCCESS(rc))
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    {
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync        int rc2 = Msg.hdr.result;
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync        if (RT_FAILURE(rc2))
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync        {
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync            rc = rc2;
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync        }
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync        else
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync        {
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync            Msg.context.GetUInt32(puContext);
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync            Msg.pid.GetUInt32(puPID);
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync            Msg.flags.GetUInt32(puFlags);
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync            Msg.size.GetUInt32(pcbSize);
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync        }
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    }
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    return rc;
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync}
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync
de210ca38246009981a22de928a52566c8c53970vboxsync/**
de210ca38246009981a22de928a52566c8c53970vboxsync * Reports the process status (along with some other stuff) to the host.
de210ca38246009981a22de928a52566c8c53970vboxsync *
de210ca38246009981a22de928a52566c8c53970vboxsync * @returns VBox status code.
de210ca38246009981a22de928a52566c8c53970vboxsync ** @todo Docs!
de210ca38246009981a22de928a52566c8c53970vboxsync */
f8df398d066204e2bf0ba209ea3554fc113fb484vboxsyncVBGLR3DECL(int) VbglR3GuestCtrlExecReportStatus(uint32_t     u32ClientId,
68e97031354932600728a42c3d454abf04f8c8d1vboxsync                                                uint32_t     u32Context,
58ca9f00941a16020aa7f72c3af005df1cb218d6vboxsync                                                uint32_t     u32PID,
58ca9f00941a16020aa7f72c3af005df1cb218d6vboxsync                                                uint32_t     u32Status,
58ca9f00941a16020aa7f72c3af005df1cb218d6vboxsync                                                uint32_t     u32Flags,
58ca9f00941a16020aa7f72c3af005df1cb218d6vboxsync                                                void        *pvData,
58ca9f00941a16020aa7f72c3af005df1cb218d6vboxsync                                                uint32_t     cbData)
de210ca38246009981a22de928a52566c8c53970vboxsync{
de210ca38246009981a22de928a52566c8c53970vboxsync    VBoxGuestCtrlHGCMMsgExecStatus Msg;
de210ca38246009981a22de928a52566c8c53970vboxsync
de210ca38246009981a22de928a52566c8c53970vboxsync    Msg.hdr.result = VERR_WRONG_ORDER;
de210ca38246009981a22de928a52566c8c53970vboxsync    Msg.hdr.u32ClientID = u32ClientId;
de210ca38246009981a22de928a52566c8c53970vboxsync    Msg.hdr.u32Function = GUEST_EXEC_SEND_STATUS;
68e97031354932600728a42c3d454abf04f8c8d1vboxsync    Msg.hdr.cParms = 5;
de210ca38246009981a22de928a52566c8c53970vboxsync
68e97031354932600728a42c3d454abf04f8c8d1vboxsync    VbglHGCMParmUInt32Set(&Msg.context, u32Context);
58ca9f00941a16020aa7f72c3af005df1cb218d6vboxsync    VbglHGCMParmUInt32Set(&Msg.pid, u32PID);
58ca9f00941a16020aa7f72c3af005df1cb218d6vboxsync    VbglHGCMParmUInt32Set(&Msg.status, u32Status);
58ca9f00941a16020aa7f72c3af005df1cb218d6vboxsync    VbglHGCMParmUInt32Set(&Msg.flags, u32Flags);
de210ca38246009981a22de928a52566c8c53970vboxsync    VbglHGCMParmPtrSet(&Msg.data, pvData, cbData);
de210ca38246009981a22de928a52566c8c53970vboxsync
de210ca38246009981a22de928a52566c8c53970vboxsync    int rc = vbglR3DoIOCtl(VBOXGUEST_IOCTL_HGCM_CALL(sizeof(Msg)), &Msg, sizeof(Msg));
de210ca38246009981a22de928a52566c8c53970vboxsync    if (RT_SUCCESS(rc))
de210ca38246009981a22de928a52566c8c53970vboxsync    {
de210ca38246009981a22de928a52566c8c53970vboxsync        int rc2 = Msg.hdr.result;
de210ca38246009981a22de928a52566c8c53970vboxsync        if (RT_FAILURE(rc2))
de210ca38246009981a22de928a52566c8c53970vboxsync            rc = rc2;
de210ca38246009981a22de928a52566c8c53970vboxsync    }
f8df398d066204e2bf0ba209ea3554fc113fb484vboxsync    return rc;
de210ca38246009981a22de928a52566c8c53970vboxsync}
de210ca38246009981a22de928a52566c8c53970vboxsync
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync/**
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync * Sends output (from stdout/stderr) from a running process.
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync *
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync * @returns VBox status code.
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync ** @todo Docs!
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync */
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsyncVBGLR3DECL(int) VbglR3GuestCtrlExecSendOut(uint32_t     u32ClientId,
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync                                           uint32_t     u32Context,
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync                                           uint32_t     u32PID,
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync                                           uint32_t     u32Handle,
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync                                           uint32_t     u32Flags,
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync                                           void        *pvData,
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync                                           uint32_t     cbData)
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync{
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync    VBoxGuestCtrlHGCMMsgExecOut Msg;
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync    Msg.hdr.result = VERR_WRONG_ORDER;
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync    Msg.hdr.u32ClientID = u32ClientId;
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync    Msg.hdr.u32Function = GUEST_EXEC_SEND_OUTPUT;
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync    Msg.hdr.cParms = 5;
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync    VbglHGCMParmUInt32Set(&Msg.context, u32Context);
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync    VbglHGCMParmUInt32Set(&Msg.pid, u32PID);
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync    VbglHGCMParmUInt32Set(&Msg.handle, u32Handle);
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync    VbglHGCMParmUInt32Set(&Msg.flags, u32Flags);
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync    VbglHGCMParmPtrSet(&Msg.data, pvData, cbData);
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync    int rc = vbglR3DoIOCtl(VBOXGUEST_IOCTL_HGCM_CALL(sizeof(Msg)), &Msg, sizeof(Msg));
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync    if (RT_SUCCESS(rc))
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync    {
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync        int rc2 = Msg.hdr.result;
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync        if (RT_FAILURE(rc2))
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync            rc = rc2;
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync    }
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync    return rc;
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync}
817d003403ed9395143bd4ba88fbd9cb60e5eeebvboxsync
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync/**
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync * Reports back the input status to the host.
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync *
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync * @returns VBox status code.
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync ** @todo Docs!
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync */
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsyncVBGLR3DECL(int) VbglR3GuestCtrlExecReportStatusIn(uint32_t     u32ClientId,
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync                                                  uint32_t     u32Context,
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync                                                  uint32_t     u32PID,
2284808ae4f8f30c11d68ef1c354e2b9c6405469vboxsync                                                  uint32_t     u32Status,
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync                                                  uint32_t     u32Flags,
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync                                                  uint32_t     cbWritten)
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync{
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    VBoxGuestCtrlHGCMMsgExecStatusIn Msg;
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    Msg.hdr.result = VERR_WRONG_ORDER;
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    Msg.hdr.u32ClientID = u32ClientId;
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    Msg.hdr.u32Function = GUEST_EXEC_SEND_INPUT_STATUS;
2284808ae4f8f30c11d68ef1c354e2b9c6405469vboxsync    Msg.hdr.cParms = 5;
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    VbglHGCMParmUInt32Set(&Msg.context, u32Context);
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    VbglHGCMParmUInt32Set(&Msg.pid, u32PID);
2284808ae4f8f30c11d68ef1c354e2b9c6405469vboxsync    VbglHGCMParmUInt32Set(&Msg.status, u32Status);
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    VbglHGCMParmUInt32Set(&Msg.flags, u32Flags);
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    VbglHGCMParmUInt32Set(&Msg.written, cbWritten);
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    int rc = vbglR3DoIOCtl(VBOXGUEST_IOCTL_HGCM_CALL(sizeof(Msg)), &Msg, sizeof(Msg));
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    if (RT_SUCCESS(rc))
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    {
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync        int rc2 = Msg.hdr.result;
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync        if (RT_FAILURE(rc2))
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync            rc = rc2;
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    }
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync    return rc;
9eea21d61089fe62b80ef3f4549600091c2b1967vboxsync}