VirtualBox

Ignore:
Timestamp:
Sep 17, 2019 1:03:39 PM (6 years ago)
Author:
vboxsync
svn:sync-xref-src-repo-rev:
133428
Message:

Shared Clipboard/URI: More renaming (URI -> transfer).

Location:
trunk/src/VBox/GuestHost/SharedClipboard
Files:
5 edited

Legend:

Unmodified
Added
Removed
  • trunk/src/VBox/GuestHost/SharedClipboard/ClipboardDataObjectImpl-win.cpp

    r80845 r80858  
    4141//#define VBOX_CLIPBOARD_WITH_UNICODE_SUPPORT 0
    4242
    43 SharedClipboardWinDataObject::SharedClipboardWinDataObject(PSHCLURITRANSFER pTransfer,
     43SharedClipboardWinDataObject::SharedClipboardWinDataObject(PSHCLTRANSFER pTransfer,
    4444                                                           LPFORMATETC pFormatEtc, LPSTGMEDIUM pStgMed, ULONG cFormats)
    4545    : m_enmStatus(Uninitialized)
     
    226226 *
    227227 * @returns VBox status code.
    228  * @param   pTransfer           URI transfer object to handle.
     228 * @param   pTransfer           Shared Clipboard transfer object to handle.
    229229 * @param   strDir              Directory path to handle.
    230230 */
    231 int SharedClipboardWinDataObject::readDir(PSHCLURITRANSFER pTransfer, const Utf8Str &strDir)
     231int SharedClipboardWinDataObject::readDir(PSHCLTRANSFER pTransfer, const Utf8Str &strDir)
    232232{
    233233    LogFlowFunc(("strDir=%s\n", strDir.c_str()));
    234234
    235235    SHCLLISTOPENPARMS openParmsList;
    236     int rc = SharedClipboardURIListOpenParmsInit(&openParmsList);
     236    int rc = SharedClipboardTransferListOpenParmsInit(&openParmsList);
    237237    if (RT_SUCCESS(rc))
    238238    {
     
    241241        {
    242242            SHCLLISTHANDLE hList;
    243             rc = SharedClipboardURITransferListOpen(pTransfer, &openParmsList, &hList);
     243            rc = SharedClipboardTransferListOpen(pTransfer, &openParmsList, &hList);
    244244            if (RT_SUCCESS(rc))
    245245            {
     
    247247
    248248                SHCLLISTHDR hdrList;
    249                 rc = SharedClipboardURITransferListGetHeader(pTransfer, hList, &hdrList);
     249                rc = SharedClipboardTransferListGetHeader(pTransfer, hList, &hdrList);
    250250                if (RT_SUCCESS(rc))
    251251                {
     
    256256                    {
    257257                        SHCLLISTENTRY entryList;
    258                         rc = SharedClipboardURITransferListRead(pTransfer, hList, &entryList);
     258                        rc = SharedClipboardTransferListRead(pTransfer, hList, &entryList);
    259259                        if (RT_SUCCESS(rc))
    260260                        {
     
    291291                }
    292292
    293                 SharedClipboardURITransferListClose(pTransfer, hList);
     293                SharedClipboardTransferListClose(pTransfer, hList);
    294294            }
    295295        }
    296296
    297         SharedClipboardURIListOpenParmsDestroy(&openParmsList);
     297        SharedClipboardTransferListOpenParmsDestroy(&openParmsList);
    298298    }
    299299
     
    303303
    304304/**
    305  * Thread for reading URI data.
    306  * The data object needs the (high level, root) URI listing at the time of ::GetData(), so we need
     305 * Thread for reading transfer data.
     306 * The data object needs the (high level, root) transfer listing at the time of ::GetData(), so we need
    307307 * to block and wait until we have this data (via this thread) and continue.
    308308 *
     
    320320    SharedClipboardWinDataObject *pThis = (SharedClipboardWinDataObject *)pvUser;
    321321
    322     PSHCLURITRANSFER pTransfer = pThis->m_pTransfer;
     322    PSHCLTRANSFER pTransfer = pThis->m_pTransfer;
    323323    AssertPtr(pTransfer);
    324324
     
    330330    LogRel2(("Shared Clipboard: Calculating transfer ...\n"));
    331331
    332     int rc = SharedClipboardURITransferOpen(pTransfer);
     332    int rc = SharedClipboardTransferOpen(pTransfer);
    333333    if (RT_SUCCESS(rc))
    334334    {
    335335        PSHCLROOTLIST pRootList;
    336         rc = SharedClipboardURILTransferRootsAsList(pTransfer, &pRootList);
     336        rc = SharedClipboardTransferLTransferRootsAsList(pTransfer, &pRootList);
    337337        if (RT_SUCCESS(rc))
    338338        {
     
    368368            }
    369369
    370             SharedClipboardURIRootListFree(pRootList);
     370            SharedClipboardTransferRootListFree(pRootList);
    371371            pRootList = NULL;
    372372
     
    390390        }
    391391
    392         SharedClipboardURITransferClose(pTransfer);
     392        SharedClipboardTransferClose(pTransfer);
    393393    }
    394394
     
    398398
    399399/**
    400  * Creates a FILEGROUPDESCRIPTOR object from a given URI transfer and stores the result into an HGLOBAL object.
     400 * Creates a FILEGROUPDESCRIPTOR object from a given Shared Clipboard transfer and stores the result into an HGLOBAL object.
    401401 *
    402402 * @returns VBox status code.
    403  * @param   pTransfer           URI transfer to create file grou desciprtor for.
     403 * @param   pTransfer           Shared Clipboard transfer to create file grou desciprtor for.
    404404 * @param   fUnicode            Whether the FILEGROUPDESCRIPTOR object shall contain Unicode data or not.
    405405 * @param   phGlobal            Where to store the allocated HGLOBAL object on success.
    406406 */
    407 int SharedClipboardWinDataObject::createFileGroupDescriptorFromTransfer(PSHCLURITRANSFER pTransfer,
     407int SharedClipboardWinDataObject::createFileGroupDescriptorFromTransfer(PSHCLTRANSFER pTransfer,
    408408                                                                        bool fUnicode, HGLOBAL *phGlobal)
    409409{
     
    558558
    559559        /* The caller can call GetData() several times, so make sure we don't do the same transfer multiple times. */
    560         if (SharedClipboardURITransferGetStatus(m_pTransfer) == SHCLURITRANSFERSTATUS_NONE)
    561         {
    562             rc = SharedClipboardURITransferPrepare(m_pTransfer);
     560        if (SharedClipboardTransferGetStatus(m_pTransfer) == SHCLTRANSFERSTATUS_NONE)
     561        {
     562            rc = SharedClipboardTransferPrepare(m_pTransfer);
    563563            if (RT_SUCCESS(rc))
    564564            {
    565565                /* Start the transfer asynchronously in a separate thread. */
    566                 rc = SharedClipboardURITransferRun(m_pTransfer, &SharedClipboardWinDataObject::readThread, this);
     566                rc = SharedClipboardTransferRun(m_pTransfer, &SharedClipboardWinDataObject::readThread, this);
    567567                if (RT_SUCCESS(rc))
    568568                {
  • trunk/src/VBox/GuestHost/SharedClipboard/ClipboardStreamImpl-win.cpp

    r80664 r80858  
    4646
    4747
    48 SharedClipboardWinStreamImpl::SharedClipboardWinStreamImpl(SharedClipboardWinDataObject *pParent, PSHCLURITRANSFER pTransfer,
     48SharedClipboardWinStreamImpl::SharedClipboardWinStreamImpl(SharedClipboardWinDataObject *pParent, PSHCLTRANSFER pTransfer,
    4949                                                           const Utf8Str &strPath, PSHCLFSOBJINFO pObjInfo)
    5050    : m_pParent(pParent)
    5151    , m_lRefCount(1) /* Our IDataObjct *always* holds the last reference to this object; needed for the callbacks. */
    52     , m_pURITransfer(pTransfer)
     52    , m_pTransfer(pTransfer)
    5353    , m_strPath(strPath)
    5454    , m_hObj(SHCLOBJHANDLE_INVALID)
     
    5757    , m_fNotifiedComplete(false)
    5858{
    59     AssertPtr(m_pURITransfer);
     59    AssertPtr(m_pTransfer);
    6060
    6161    LogFunc(("m_strPath=%s\n", m_strPath.c_str()));
     
    185185    {
    186186        if (   m_hObj == SHCLOBJHANDLE_INVALID
    187             && m_pURITransfer->ProviderIface.pfnObjOpen)
     187            && m_pTransfer->ProviderIface.pfnObjOpen)
    188188        {
    189189            SHCLOBJOPENCREATEPARMS openParms;
    190             rc = SharedClipboardURIObjectOpenParmsInit(&openParms);
     190            rc = SharedClipboardTransferObjectOpenParmsInit(&openParms);
    191191            if (RT_SUCCESS(rc))
    192192            {
     
    199199                if (RT_SUCCESS(rc))
    200200                {
    201                     rc = m_pURITransfer->ProviderIface.pfnObjOpen(&m_pURITransfer->ProviderCtx, &openParms, &m_hObj);
     201                    rc = m_pTransfer->ProviderIface.pfnObjOpen(&m_pTransfer->ProviderCtx, &openParms, &m_hObj);
    202202                }
    203203
    204                 SharedClipboardURIObjectOpenParmsDestroy(&openParms);
     204                SharedClipboardTransferObjectOpenParmsDestroy(&openParms);
    205205            }
    206206        }
     
    219219            if (cbToRead)
    220220            {
    221                 rc = m_pURITransfer->ProviderIface.pfnObjRead(&m_pURITransfer->ProviderCtx, m_hObj,
    222                                                               pvBuffer, cbToRead, 0 /* fFlags */, &cbRead);
     221                rc = m_pTransfer->ProviderIface.pfnObjRead(&m_pTransfer->ProviderCtx, m_hObj,
     222                                                           pvBuffer, cbToRead, 0 /* fFlags */, &cbRead);
    223223                if (RT_SUCCESS(rc))
    224224                {
     
    233233            if (fComplete)
    234234            {
    235                 if (m_pURITransfer->ProviderIface.pfnObjClose)
     235                if (m_pTransfer->ProviderIface.pfnObjClose)
    236236                {
    237                     int rc2 = m_pURITransfer->ProviderIface.pfnObjClose(&m_pURITransfer->ProviderCtx, m_hObj);
     237                    int rc2 = m_pTransfer->ProviderIface.pfnObjClose(&m_pTransfer->ProviderCtx, m_hObj);
    238238                    AssertRC(rc2);
    239239                }
     
    356356 * @returns HRESULT
    357357 * @param   pParent             Pointer to the parent data object.
    358  * @param   pTransfer           Pointer to URI transfer object to use.
     358 * @param   pTransfer           Pointer to Shared Clipboard transfer object to use.
    359359 * @param   strPath             Path of object to handle for the stream.
    360360 * @param   pObjInfo            Pointer to object information.
     
    362362 */
    363363/* static */
    364 HRESULT SharedClipboardWinStreamImpl::Create(SharedClipboardWinDataObject *pParent, PSHCLURITRANSFER pTransfer,
     364HRESULT SharedClipboardWinStreamImpl::Create(SharedClipboardWinDataObject *pParent, PSHCLTRANSFER pTransfer,
    365365                                             const Utf8Str &strPath, PSHCLFSOBJINFO pObjInfo,
    366366                                             IStream **ppStream)
  • trunk/src/VBox/GuestHost/SharedClipboard/clipboard-common.cpp

    r80847 r80858  
    829829        RT_CASE_RET_STR(VBOX_SHCL_HOST_MSG_READ_DATA);
    830830        RT_CASE_RET_STR(VBOX_SHCL_HOST_MSG_FORMATS_REPORT);
    831         RT_CASE_RET_STR(VBOX_SHCL_HOST_MSG_URI_TRANSFER_STATUS);
    832         RT_CASE_RET_STR(VBOX_SHCL_HOST_MSG_URI_ROOT_LIST_HDR_READ);
    833         RT_CASE_RET_STR(VBOX_SHCL_HOST_MSG_URI_ROOT_LIST_HDR_WRITE);
    834         RT_CASE_RET_STR(VBOX_SHCL_HOST_MSG_URI_ROOT_LIST_ENTRY_READ);
    835         RT_CASE_RET_STR(VBOX_SHCL_HOST_MSG_URI_ROOT_LIST_ENTRY_WRITE);
    836         RT_CASE_RET_STR(VBOX_SHCL_HOST_MSG_URI_LIST_OPEN);
    837         RT_CASE_RET_STR(VBOX_SHCL_HOST_MSG_URI_LIST_CLOSE);
    838         RT_CASE_RET_STR(VBOX_SHCL_HOST_MSG_URI_LIST_HDR_READ);
    839         RT_CASE_RET_STR(VBOX_SHCL_HOST_MSG_URI_LIST_HDR_WRITE);
    840         RT_CASE_RET_STR(VBOX_SHCL_HOST_MSG_URI_LIST_ENTRY_READ);
    841         RT_CASE_RET_STR(VBOX_SHCL_HOST_MSG_URI_LIST_ENTRY_WRITE);
    842         RT_CASE_RET_STR(VBOX_SHCL_HOST_MSG_URI_OBJ_OPEN);
    843         RT_CASE_RET_STR(VBOX_SHCL_HOST_MSG_URI_OBJ_CLOSE);
    844         RT_CASE_RET_STR(VBOX_SHCL_HOST_MSG_URI_OBJ_READ);
    845         RT_CASE_RET_STR(VBOX_SHCL_HOST_MSG_URI_OBJ_WRITE);
    846         RT_CASE_RET_STR(VBOX_SHCL_HOST_MSG_URI_CANCEL);
    847         RT_CASE_RET_STR(VBOX_SHCL_HOST_MSG_URI_ERROR);
     831        RT_CASE_RET_STR(VBOX_SHCL_HOST_MSG_TRANSFER_TRANSFER_STATUS);
     832        RT_CASE_RET_STR(VBOX_SHCL_HOST_MSG_TRANSFER_ROOT_LIST_HDR_READ);
     833        RT_CASE_RET_STR(VBOX_SHCL_HOST_MSG_TRANSFER_ROOT_LIST_HDR_WRITE);
     834        RT_CASE_RET_STR(VBOX_SHCL_HOST_MSG_TRANSFER_ROOT_LIST_ENTRY_READ);
     835        RT_CASE_RET_STR(VBOX_SHCL_HOST_MSG_TRANSFER_ROOT_LIST_ENTRY_WRITE);
     836        RT_CASE_RET_STR(VBOX_SHCL_HOST_MSG_TRANSFER_LIST_OPEN);
     837        RT_CASE_RET_STR(VBOX_SHCL_HOST_MSG_TRANSFER_LIST_CLOSE);
     838        RT_CASE_RET_STR(VBOX_SHCL_HOST_MSG_TRANSFER_LIST_HDR_READ);
     839        RT_CASE_RET_STR(VBOX_SHCL_HOST_MSG_TRANSFER_LIST_HDR_WRITE);
     840        RT_CASE_RET_STR(VBOX_SHCL_HOST_MSG_TRANSFER_LIST_ENTRY_READ);
     841        RT_CASE_RET_STR(VBOX_SHCL_HOST_MSG_TRANSFER_LIST_ENTRY_WRITE);
     842        RT_CASE_RET_STR(VBOX_SHCL_HOST_MSG_TRANSFER_OBJ_OPEN);
     843        RT_CASE_RET_STR(VBOX_SHCL_HOST_MSG_TRANSFER_OBJ_CLOSE);
     844        RT_CASE_RET_STR(VBOX_SHCL_HOST_MSG_TRANSFER_OBJ_READ);
     845        RT_CASE_RET_STR(VBOX_SHCL_HOST_MSG_TRANSFER_OBJ_WRITE);
     846        RT_CASE_RET_STR(VBOX_SHCL_HOST_MSG_TRANSFER_CANCEL);
     847        RT_CASE_RET_STR(VBOX_SHCL_HOST_MSG_TRANSFER_ERROR);
    848848    }
    849849    return "Unknown";
  • trunk/src/VBox/GuestHost/SharedClipboard/clipboard-uri.cpp

    r80847 r80858  
    11/* $Id$ */
    22/** @file
    3  * Shared Clipboard: Common URI transfer handling code.
     3 * Shared Clipboard: Common Shared Clipboard transfer handling code.
    44 */
    55
     
    3131
    3232
    33 static int sharedClipboardURITransferThreadCreate(PSHCLURITRANSFER pTransfer, PFNRTTHREAD pfnThreadFunc, void *pvUser);
    34 static int sharedClipboardURITransferThreadDestroy(PSHCLURITRANSFER pTransfer, RTMSINTERVAL uTimeoutMs);
    35 static PSHCLURITRANSFER sharedClipboardURICtxGetTransferInternal(PSHCLURICTX pURI, uint32_t uIdx);
     33static int sharedClipboardTransferThreadCreate(PSHCLTRANSFER pTransfer, PFNRTTHREAD pfnThreadFunc, void *pvUser);
     34static int sharedClipboardTransferThreadDestroy(PSHCLTRANSFER pTransfer, RTMSINTERVAL uTimeoutMs);
     35static PSHCLTRANSFER sharedClipboardTransferCtxGetTransferInternal(PSHCLTRANSFERCTX pTransferCtx, uint32_t uIdx);
    3636static int sharedClipboardConvertFileCreateFlags(bool fWritable, unsigned fShClFlags, RTFMODE fMode,
    3737                                                 SHCLOBJHANDLE handleInitial, uint64_t *pfOpen);
     
    4040
    4141/**
    42  * Allocates a new URI root list.
    43  *
    44  * @returns Allocated URI root list on success, or NULL on failure.
    45  */
    46 PSHCLROOTLIST SharedClipboardURIRootListAlloc(void)
     42 * Allocates a new transfer root list.
     43 *
     44 * @returns Allocated transfer root list on success, or NULL on failure.
     45 */
     46PSHCLROOTLIST SharedClipboardTransferRootListAlloc(void)
    4747{
    4848    PSHCLROOTLIST pRootList = (PSHCLROOTLIST)RTMemAllocZ(sizeof(SHCLROOTLIST));
     
    5252
    5353/**
    54  * Frees an URI root list.
    55  *
    56  * @param   pRootList           URI root list to free. The pointer will be
     54 * Frees a transfer root list.
     55 *
     56 * @param   pRootList           transfer root list to free. The pointer will be
    5757 *                              invalid after returning from this function.
    5858 */
    59 void SharedClipboardURIRootListFree(PSHCLROOTLIST pRootList)
     59void SharedClipboardTransferRootListFree(PSHCLROOTLIST pRootList)
    6060{
    6161    if (!pRootList)
     
    6363
    6464    for (uint32_t i = 0; i < pRootList->Hdr.cRoots; i++)
    65         SharedClipboardURIListEntryDestroy(&pRootList->paEntries[i]);
     65        SharedClipboardTransferListEntryDestroy(&pRootList->paEntries[i]);
    6666
    6767    RTMemFree(pRootList);
     
    7070
    7171/**
    72  * Initializes an URI root list header.
     72 * Initializes a transfer root list header.
    7373 *
    7474 * @returns VBox status code.
    7575 * @param   pRootLstHdr         Root list header to initialize.
    7676 */
    77 int SharedClipboardURIRootListHdrInit(PSHCLROOTLISTHDR pRootLstHdr)
     77int SharedClipboardTransferRootListHdrInit(PSHCLROOTLISTHDR pRootLstHdr)
    7878{
    7979    AssertPtrReturn(pRootLstHdr, VERR_INVALID_POINTER);
     
    8585
    8686/**
    87  * Destroys an URI root list header.
     87 * Destroys a transfer root list header.
    8888 *
    8989 * @param   pRootLstHdr         Root list header to destroy.
    9090 */
    91 void SharedClipboardURIRootListHdrDestroy(PSHCLROOTLISTHDR pRootLstHdr)
     91void SharedClipboardTransferRootListHdrDestroy(PSHCLROOTLISTHDR pRootLstHdr)
    9292{
    9393    if (!pRootLstHdr)
     
    9999
    100100/**
    101  * Duplicates an URI list header.
    102  *
    103  * @returns Duplicated URI list header on success, or NULL on failure.
     101 * Duplicates a transfer list header.
     102 *
     103 * @returns Duplicated transfer list header on success, or NULL on failure.
    104104 * @param   pRootLstHdr         Root list header to duplicate.
    105105 */
    106 PSHCLROOTLISTHDR SharedClipboardURIRootListHdrDup(PSHCLROOTLISTHDR pRootLstHdr)
     106PSHCLROOTLISTHDR SharedClipboardTransferRootListHdrDup(PSHCLROOTLISTHDR pRootLstHdr)
    107107{
    108108    AssertPtrReturn(pRootLstHdr, NULL);
     
    120120    if (RT_FAILURE(rc))
    121121    {
    122         SharedClipboardURIRootListHdrDestroy(pRootsDup);
     122        SharedClipboardTransferRootListHdrDestroy(pRootsDup);
    123123        pRootsDup = NULL;
    124124    }
     
    133133 * @param   pListEntry          Clipboard root list entry to copy.
    134134 */
    135 int SharedClipboardURIRootListEntryCopy(PSHCLROOTLISTENTRY pDst, PSHCLROOTLISTENTRY pSrc)
    136 {
    137     return SharedClipboardURIListEntryCopy(pDst, pSrc);
     135int SharedClipboardTransferRootListEntryCopy(PSHCLROOTLISTENTRY pDst, PSHCLROOTLISTENTRY pSrc)
     136{
     137    return SharedClipboardTransferListEntryCopy(pDst, pSrc);
    138138}
    139139
     
    144144 * @param   pListEntry          Clipboard root list entry to duplicate.
    145145 */
    146 PSHCLROOTLISTENTRY SharedClipboardURIRootListEntryDup(PSHCLROOTLISTENTRY pRootListEntry)
    147 {
    148     return SharedClipboardURIListEntryDup(pRootListEntry);
     146PSHCLROOTLISTENTRY SharedClipboardTransferRootListEntryDup(PSHCLROOTLISTENTRY pRootListEntry)
     147{
     148    return SharedClipboardTransferListEntryDup(pRootListEntry);
    149149}
    150150
     
    154154 * @param   pListEntry          Clipboard root list entry structure to destroy.
    155155 */
    156 void SharedClipboardURIRootListEntryDestroy(PSHCLROOTLISTENTRY pRootListEntry)
    157 {
    158     return SharedClipboardURIListEntryDestroy(pRootListEntry);
     156void SharedClipboardTransferRootListEntryDestroy(PSHCLROOTLISTENTRY pRootListEntry)
     157{
     158    return SharedClipboardTransferListEntryDestroy(pRootListEntry);
    159159}
    160160
     
    164164 * @param   pInfo               List handle info structure to destroy.
    165165 */
    166 void SharedClipboardURIListHandleInfoDestroy(PSHCLURILISTHANDLEINFO pInfo)
     166void SharedClipboardTransferListHandleInfoDestroy(PSHCLLISTHANDLEINFO pInfo)
    167167{
    168168    if (!pInfo)
     
    177177
    178178/**
    179  * Allocates a URI list header structure.
    180  *
    181  * @returns VBox status code.
    182  * @param   ppListHdr           Where to store the allocated URI list header structure on success.
    183  */
    184 int SharedClipboardURIListHdrAlloc(PSHCLLISTHDR *ppListHdr)
     179 * Allocates a transfer list header structure.
     180 *
     181 * @returns VBox status code.
     182 * @param   ppListHdr           Where to store the allocated transfer list header structure on success.
     183 */
     184int SharedClipboardTransferListHdrAlloc(PSHCLLISTHDR *ppListHdr)
    185185{
    186186    int rc;
     
    200200
    201201/**
    202  * Frees an URI list header structure.
    203  *
    204  * @param   pListEntry          URI list header structure to free.
    205  */
    206 void SharedClipboardURIListHdrFree(PSHCLLISTHDR pListHdr)
     202 * Frees a transfer list header structure.
     203 *
     204 * @param   pListEntry          transfer list header structure to free.
     205 */
     206void SharedClipboardTransferListHdrFree(PSHCLLISTHDR pListHdr)
    207207{
    208208    if (!pListHdr)
     
    211211    LogFlowFuncEnter();
    212212
    213     SharedClipboardURIListHdrDestroy(pListHdr);
     213    SharedClipboardTransferListHdrDestroy(pListHdr);
    214214
    215215    RTMemFree(pListHdr);
     
    218218
    219219/**
    220  * Duplicates (allocates) an URI list header structure.
    221  *
    222  * @returns Duplicated URI list header structure on success.
    223  * @param   pListHdr            URI list header to duplicate.
    224  */
    225 PSHCLLISTHDR SharedClipboardURIListHdrDup(PSHCLLISTHDR pListHdr)
     220 * Duplicates (allocates) a transfer list header structure.
     221 *
     222 * @returns Duplicated transfer list header structure on success.
     223 * @param   pListHdr            transfer list header to duplicate.
     224 */
     225PSHCLLISTHDR SharedClipboardTransferListHdrDup(PSHCLLISTHDR pListHdr)
    226226{
    227227    AssertPtrReturn(pListHdr, NULL);
     
    237237
    238238/**
    239  * Initializes an URI data header struct.
     239 * Initializes a transfer data header struct.
    240240 *
    241241 * @returns VBox status code.
    242242 * @param   pListHdr            Data header struct to initialize.
    243243 */
    244 int SharedClipboardURIListHdrInit(PSHCLLISTHDR pListHdr)
     244int SharedClipboardTransferListHdrInit(PSHCLLISTHDR pListHdr)
    245245{
    246246    AssertPtrReturn(pListHdr, VERR_INVALID_POINTER);
     
    248248    LogFlowFuncEnter();
    249249
    250     SharedClipboardURIListHdrReset(pListHdr);
     250    SharedClipboardTransferListHdrReset(pListHdr);
    251251
    252252    return VINF_SUCCESS;
     
    254254
    255255/**
    256  * Destroys an URI data header struct.
     256 * Destroys a transfer data header struct.
    257257 *
    258258 * @param   pListHdr            Data header struct to destroy.
    259259 */
    260 void SharedClipboardURIListHdrDestroy(PSHCLLISTHDR pListHdr)
     260void SharedClipboardTransferListHdrDestroy(PSHCLLISTHDR pListHdr)
    261261{
    262262    if (!pListHdr)
     
    272272 * @param   pListHdr            SHCLListHdr structture to reset.
    273273 */
    274 void SharedClipboardURIListHdrReset(PSHCLLISTHDR pListHdr)
     274void SharedClipboardTransferListHdrReset(PSHCLLISTHDR pListHdr)
    275275{
    276276    AssertPtrReturnVoid(pListHdr);
     
    287287 * @param   pListHdr            Clipboard data header to validate.
    288288 */
    289 bool SharedClipboardURIListHdrIsValid(PSHCLLISTHDR pListHdr)
     289bool SharedClipboardTransferListHdrIsValid(PSHCLLISTHDR pListHdr)
    290290{
    291291    RT_NOREF(pListHdr);
     
    293293}
    294294
    295 int SharedClipboardURIListOpenParmsCopy(PSHCLLISTOPENPARMS pDst, PSHCLLISTOPENPARMS pSrc)
     295int SharedClipboardTransferListOpenParmsCopy(PSHCLLISTOPENPARMS pDst, PSHCLLISTOPENPARMS pSrc)
    296296{
    297297    AssertPtrReturn(pDst, VERR_INVALID_POINTER);
     
    326326
    327327/**
    328  * Duplicates an URI list open parameters structure.
    329  *
    330  * @returns Duplicated URI list open parameters structure on success, or NULL on failure.
    331  * @param   pParms              URI list open parameters structure to duplicate.
    332  */
    333 PSHCLLISTOPENPARMS SharedClipboardURIListOpenParmsDup(PSHCLLISTOPENPARMS pParms)
     328 * Duplicates a transfer list open parameters structure.
     329 *
     330 * @returns Duplicated transfer list open parameters structure on success, or NULL on failure.
     331 * @param   pParms              transfer list open parameters structure to duplicate.
     332 */
     333PSHCLLISTOPENPARMS SharedClipboardTransferListOpenParmsDup(PSHCLLISTOPENPARMS pParms)
    334334{
    335335    AssertPtrReturn(pParms, NULL);
     
    339339        return NULL;
    340340
    341     int rc = SharedClipboardURIListOpenParmsCopy(pParmsDup, pParms);
     341    int rc = SharedClipboardTransferListOpenParmsCopy(pParmsDup, pParms);
    342342    if (RT_FAILURE(rc))
    343343    {
    344         SharedClipboardURIListOpenParmsDestroy(pParmsDup);
     344        SharedClipboardTransferListOpenParmsDestroy(pParmsDup);
    345345
    346346        RTMemFree(pParmsDup);
     
    352352
    353353/**
    354  * Initializes an URI list open parameters structure.
    355  *
    356  * @returns VBox status code.
    357  * @param   pParms              URI list open parameters structure to initialize.
    358  */
    359 int SharedClipboardURIListOpenParmsInit(PSHCLLISTOPENPARMS pParms)
     354 * Initializes a transfer list open parameters structure.
     355 *
     356 * @returns VBox status code.
     357 * @param   pParms              transfer list open parameters structure to initialize.
     358 */
     359int SharedClipboardTransferListOpenParmsInit(PSHCLLISTOPENPARMS pParms)
    360360{
    361361    AssertPtrReturn(pParms, VERR_INVALID_POINTER);
     
    374374
    375375/**
    376  * Destroys an URI list open parameters structure.
    377  *
    378  * @param   pParms              URI list open parameters structure to destroy.
    379  */
    380 void SharedClipboardURIListOpenParmsDestroy(PSHCLLISTOPENPARMS pParms)
     376 * Destroys a transfer list open parameters structure.
     377 *
     378 * @param   pParms              transfer list open parameters structure to destroy.
     379 */
     380void SharedClipboardTransferListOpenParmsDestroy(PSHCLLISTOPENPARMS pParms)
    381381{
    382382    if (!pParms)
     
    401401 * @param   ppDirData           Where to return the created clipboard list entry structure on success.
    402402 */
    403 int SharedClipboardURIListEntryAlloc(PSHCLLISTENTRY *ppListEntry)
     403int SharedClipboardTransferListEntryAlloc(PSHCLLISTENTRY *ppListEntry)
    404404{
    405405    PSHCLLISTENTRY pListEntry = (PSHCLLISTENTRY)RTMemAlloc(sizeof(SHCLLISTENTRY));
     
    407407        return VERR_NO_MEMORY;
    408408
    409     int rc = SharedClipboardURIListEntryInit(pListEntry);
     409    int rc = SharedClipboardTransferListEntryInit(pListEntry);
    410410    if (RT_SUCCESS(rc))
    411411        *ppListEntry = pListEntry;
     
    419419 * @param   pListEntry         Clipboard list entry structure to free.
    420420 */
    421 void SharedClipboardURIListEntryFree(PSHCLLISTENTRY pListEntry)
     421void SharedClipboardTransferListEntryFree(PSHCLLISTENTRY pListEntry)
    422422{
    423423    if (!pListEntry)
    424424        return;
    425425
    426     SharedClipboardURIListEntryDestroy(pListEntry);
     426    SharedClipboardTransferListEntryDestroy(pListEntry);
    427427    RTMemFree(pListEntry);
    428428}
     
    434434 * @param   pListEntry          Clipboard list entry to copy.
    435435 */
    436 int SharedClipboardURIListEntryCopy(PSHCLLISTENTRY pDst, PSHCLLISTENTRY pSrc)
     436int SharedClipboardTransferListEntryCopy(PSHCLLISTENTRY pDst, PSHCLLISTENTRY pSrc)
    437437{
    438438    AssertPtrReturn(pDst, VERR_INVALID_POINTER);
     
    481481 * @param   pListEntry          Clipboard list entry to duplicate.
    482482 */
    483 PSHCLLISTENTRY SharedClipboardURIListEntryDup(PSHCLLISTENTRY pListEntry)
     483PSHCLLISTENTRY SharedClipboardTransferListEntryDup(PSHCLLISTENTRY pListEntry)
    484484{
    485485    AssertPtrReturn(pListEntry, NULL);
     
    489489    PSHCLLISTENTRY pListEntryDup = (PSHCLLISTENTRY)RTMemAllocZ(sizeof(SHCLLISTENTRY));
    490490    if (pListEntryDup)
    491         rc = SharedClipboardURIListEntryCopy(pListEntryDup, pListEntry);
     491        rc = SharedClipboardTransferListEntryCopy(pListEntryDup, pListEntry);
    492492
    493493    if (RT_FAILURE(rc))
    494494    {
    495         SharedClipboardURIListEntryDestroy(pListEntryDup);
     495        SharedClipboardTransferListEntryDestroy(pListEntryDup);
    496496
    497497        RTMemFree(pListEntryDup);
     
    508508 * @param   pListEntry          Clipboard list entry structure to initialize.
    509509 */
    510 int SharedClipboardURIListEntryInit(PSHCLLISTENTRY pListEntry)
     510int SharedClipboardTransferListEntryInit(PSHCLLISTENTRY pListEntry)
    511511{
    512512    RT_BZERO(pListEntry, sizeof(SHCLLISTENTRY));
     
    529529 * @param   pListEntry          Clipboard list entry structure to destroy.
    530530 */
    531 void SharedClipboardURIListEntryDestroy(PSHCLLISTENTRY pListEntry)
     531void SharedClipboardTransferListEntryDestroy(PSHCLLISTENTRY pListEntry)
    532532{
    533533    if (!pListEntry)
     
    556556 * @param   pListEntry          Clipboard data chunk to validate.
    557557 */
    558 bool SharedClipboardURIListEntryIsValid(PSHCLLISTENTRY pListEntry)
     558bool SharedClipboardTransferListEntryIsValid(PSHCLLISTENTRY pListEntry)
    559559{
    560560    RT_NOREF(pListEntry);
     
    566566
    567567/**
    568  * Initializes an URI object context.
    569  *
    570  * @returns VBox status code.
    571  * @param   pObjCtx             URI object context to initialize.
    572  */
    573 int SharedClipboardURIObjCtxInit(PSHCLCLIENTURIOBJCTX pObjCtx)
     568 * Initializes a transfer object context.
     569 *
     570 * @returns VBox status code.
     571 * @param   pObjCtx             transfer object context to initialize.
     572 */
     573int SharedClipboardTransferObjCtxInit(PSHCLCLIENTTRANSFEROBJCTX pObjCtx)
    574574{
    575575    AssertPtrReturn(pObjCtx, VERR_INVALID_POINTER);
     
    583583
    584584/**
    585  * Destroys an URI object context.
    586  *
    587  * @param   pObjCtx             URI object context to destroy.
    588  */
    589 void SharedClipboardURIObjCtxDestroy(PSHCLCLIENTURIOBJCTX pObjCtx)
     585 * Destroys a transfer object context.
     586 *
     587 * @param   pObjCtx             transfer object context to destroy.
     588 */
     589void SharedClipboardTransferObjCtxDestroy(PSHCLCLIENTTRANSFEROBJCTX pObjCtx)
    590590{
    591591    AssertPtrReturnVoid(pObjCtx);
     
    595595
    596596/**
    597  * Returns if an URI object context is valid or not.
     597 * Returns if a transfer object context is valid or not.
    598598 *
    599599 * @returns \c true if valid, \c false if not.
    600  * @param   pObjCtx             URI object context to check.
    601  */
    602 bool SharedClipboardURIObjCtxIsValid(PSHCLCLIENTURIOBJCTX pObjCtx)
     600 * @param   pObjCtx             transfer object context to check.
     601 */
     602bool SharedClipboardTransferObjCtxIsValid(PSHCLCLIENTTRANSFEROBJCTX pObjCtx)
    603603{
    604604    return (   pObjCtx
     
    611611 * @param   pInfo               Object handle info structure to destroy.
    612612 */
    613 void SharedClipboardURIObjectHandleInfoDestroy(PSHCLURIOBJHANDLEINFO pInfo)
     613void SharedClipboardTransferObjectHandleInfoDestroy(PSHCLOBJHANDLEINFO pInfo)
    614614{
    615615    if (!pInfo)
     
    624624
    625625/**
    626  * Initializes an URI object open parameters structure.
    627  *
    628  * @returns VBox status code.
    629  * @param   pParms              URI object open parameters structure to initialize.
    630  */
    631 int SharedClipboardURIObjectOpenParmsInit(PSHCLOBJOPENCREATEPARMS pParms)
     626 * Initializes a transfer object open parameters structure.
     627 *
     628 * @returns VBox status code.
     629 * @param   pParms              transfer object open parameters structure to initialize.
     630 */
     631int SharedClipboardTransferObjectOpenParmsInit(PSHCLOBJOPENCREATEPARMS pParms)
    632632{
    633633    AssertPtrReturn(pParms, VERR_INVALID_POINTER);
     
    651651
    652652/**
    653  * Copies an URI object open parameters structure from source to destination.
    654  *
    655  * @returns VBox status code.
    656  * @param   pParmsDst           Where to copy the source URI object open parameters to.
    657  * @param   pParmsSrc           Which source URI object open parameters to copy.
    658  */
    659 int SharedClipboardURIObjectOpenParmsCopy(PSHCLOBJOPENCREATEPARMS pParmsDst, PSHCLOBJOPENCREATEPARMS pParmsSrc)
     653 * Copies a transfer object open parameters structure from source to destination.
     654 *
     655 * @returns VBox status code.
     656 * @param   pParmsDst           Where to copy the source transfer object open parameters to.
     657 * @param   pParmsSrc           Which source transfer object open parameters to copy.
     658 */
     659int SharedClipboardTransferObjectOpenParmsCopy(PSHCLOBJOPENCREATEPARMS pParmsDst, PSHCLOBJOPENCREATEPARMS pParmsSrc)
    660660{
    661661    int rc;
     
    682682
    683683/**
    684  * Destroys an URI object open parameters structure.
    685  *
    686  * @param   pParms              URI object open parameters structure to destroy.
    687  */
    688 void SharedClipboardURIObjectOpenParmsDestroy(PSHCLOBJOPENCREATEPARMS pParms)
     684 * Destroys a transfer object open parameters structure.
     685 *
     686 * @param   pParms              transfer object open parameters structure to destroy.
     687 */
     688void SharedClipboardTransferObjectOpenParmsDestroy(PSHCLOBJOPENCREATEPARMS pParms)
    689689{
    690690    if (!pParms)
     
    702702 *
    703703 * @returns Pointer to object handle info if found, or NULL if not found.
    704  * @param   pTransfer           URI clipboard transfer to get object handle info from.
     704 * @param   pTransfer           Clipboard transfer to get object handle info from.
    705705 * @param   hObj                Object handle of the object to get handle info for.
    706706 */
    707 inline PSHCLURIOBJHANDLEINFO sharedClipboardURIObjectGet(PSHCLURITRANSFER pTransfer,
    708                                                                     SHCLOBJHANDLE hObj)
    709 {
    710     PSHCLURIOBJHANDLEINFO pIt;
    711     RTListForEach(&pTransfer->lstObj, pIt, SHCLURIOBJHANDLEINFO, Node)
     707inline PSHCLOBJHANDLEINFO sharedClipboardTransferObjectGet(PSHCLTRANSFER pTransfer,
     708                                                           SHCLOBJHANDLE hObj)
     709{
     710    PSHCLOBJHANDLEINFO pIt;
     711    RTListForEach(&pTransfer->lstObj, pIt, SHCLOBJHANDLEINFO, Node)
    712712    {
    713713        if (pIt->hObj == hObj)
     
    719719
    720720/**
    721  * Opens an URI object.
    722  *
    723  * @returns VBox status code.
    724  * @param   pTransfer           URI clipboard transfer to open the object for.
    725  * @param   pOpenCreateParms    Open / create parameters of URI object to open / create.
    726  * @param   phObj               Where to store the handle of URI object opened on success.
    727  */
    728 int SharedClipboardURIObjectOpen(PSHCLURITRANSFER pTransfer, PSHCLOBJOPENCREATEPARMS pOpenCreateParms,
    729                                  PSHCLOBJHANDLE phObj)
     721 * Opens a transfer object.
     722 *
     723 * @returns VBox status code.
     724 * @param   pTransfer           Clipboard transfer to open the object for.
     725 * @param   pOpenCreateParms    Open / create parameters of transfer object to open / create.
     726 * @param   phObj               Where to store the handle of transfer object opened on success.
     727 */
     728int SharedClipboardTransferObjectOpen(PSHCLTRANSFER pTransfer, PSHCLOBJOPENCREATEPARMS pOpenCreateParms,
     729                                      PSHCLOBJHANDLE phObj)
    730730{
    731731    AssertPtrReturn(pTransfer,        VERR_INVALID_POINTER);
     
    739739    if (pTransfer->State.enmSource == SHCLSOURCE_LOCAL)
    740740    {
    741         PSHCLURIOBJHANDLEINFO pInfo
    742             = (PSHCLURIOBJHANDLEINFO)RTMemAlloc(sizeof(SHCLURIOBJHANDLEINFO));
     741        PSHCLOBJHANDLEINFO pInfo
     742            = (PSHCLOBJHANDLEINFO)RTMemAlloc(sizeof(SHCLOBJHANDLEINFO));
    743743        if (pInfo)
    744744        {
     
    766766            {
    767767                pInfo->hObj    = pTransfer->uObjHandleNext++;
    768                 pInfo->enmType = SHCLURIOBJTYPE_FILE;
     768                pInfo->enmType = SHCLOBJTYPE_FILE;
    769769
    770770                RTListAppend(&pTransfer->lstObj, &pInfo->Node);
     
    794794
    795795/**
    796  * Closes an URI object.
    797  *
    798  * @returns VBox status code.
    799  * @param   pTransfer           URI clipboard transfer that contains the object to close.
    800  * @param   hObj                Handle of URI object to close.
    801  */
    802 int SharedClipboardURIObjectClose(PSHCLURITRANSFER pTransfer, SHCLOBJHANDLE hObj)
     796 * Closes a transfer object.
     797 *
     798 * @returns VBox status code.
     799 * @param   pTransfer           Clipboard transfer that contains the object to close.
     800 * @param   hObj                Handle of transfer object to close.
     801 */
     802int SharedClipboardTransferObjectClose(PSHCLTRANSFER pTransfer, SHCLOBJHANDLE hObj)
    803803{
    804804    AssertPtrReturn(pTransfer, VERR_INVALID_POINTER);
     
    808808    if (pTransfer->State.enmSource == SHCLSOURCE_LOCAL)
    809809    {
    810         PSHCLURIOBJHANDLEINFO pInfo = sharedClipboardURIObjectGet(pTransfer, hObj);
     810        PSHCLOBJHANDLEINFO pInfo = sharedClipboardTransferObjectGet(pTransfer, hObj);
    811811        if (pInfo)
    812812        {
    813813            switch (pInfo->enmType)
    814814            {
    815                 case SHCLURIOBJTYPE_DIRECTORY:
     815                case SHCLOBJTYPE_DIRECTORY:
    816816                {
    817817                    rc = RTDirClose(pInfo->u.Local.hDir);
     
    821821                }
    822822
    823                 case SHCLURIOBJTYPE_FILE:
     823                case SHCLOBJTYPE_FILE:
    824824                {
    825825                    rc = RTFileClose(pInfo->u.Local.hFile);
     
    856856
    857857/**
    858  * Reads from an URI object.
    859  *
    860  * @returns VBox status code.
    861  * @param   pTransfer           URI clipboard transfer that contains the object to read from.
    862  * @param   hObj                Handle of URI object to read from.
     858 * Reads from a transfer object.
     859 *
     860 * @returns VBox status code.
     861 * @param   pTransfer           Clipboard transfer that contains the object to read from.
     862 * @param   hObj                Handle of transfer object to read from.
    863863 * @param   pvBuf               Buffer for where to store the read data.
    864864 * @param   cbBuf               Size (in bytes) of buffer.
    865865 * @param   pcbRead             How much bytes were read on success. Optional.
    866866 */
    867 int SharedClipboardURIObjectRead(PSHCLURITRANSFER pTransfer,
    868                                  SHCLOBJHANDLE hObj, void *pvBuf, uint32_t cbBuf, uint32_t *pcbRead, uint32_t fFlags)
     867int SharedClipboardTransferObjectRead(PSHCLTRANSFER pTransfer,
     868                                      SHCLOBJHANDLE hObj, void *pvBuf, uint32_t cbBuf, uint32_t *pcbRead, uint32_t fFlags)
    869869{
    870870    AssertPtrReturn(pTransfer, VERR_INVALID_POINTER);
     
    878878    if (pTransfer->State.enmSource == SHCLSOURCE_LOCAL)
    879879    {
    880         PSHCLURIOBJHANDLEINFO pInfo = sharedClipboardURIObjectGet(pTransfer, hObj);
     880        PSHCLOBJHANDLEINFO pInfo = sharedClipboardTransferObjectGet(pTransfer, hObj);
    881881        if (pInfo)
    882882        {
    883883            switch (pInfo->enmType)
    884884            {
    885                 case SHCLURIOBJTYPE_FILE:
     885                case SHCLOBJTYPE_FILE:
    886886                {
    887887                    size_t cbRead;
     
    918918
    919919/**
    920  * Writes to an URI object.
    921  *
    922  * @returns VBox status code.
    923  * @param   pTransfer           URI clipboard transfer that contains the object to write to.
    924  * @param   hObj                Handle of URI object to write to.
     920 * Writes to a transfer object.
     921 *
     922 * @returns VBox status code.
     923 * @param   pTransfer           Clipboard transfer that contains the object to write to.
     924 * @param   hObj                Handle of transfer object to write to.
    925925 * @param   pvBuf               Buffer of data to write.
    926926 * @param   cbBuf               Size (in bytes) of buffer to write.
    927927 * @param   pcbWritten          How much bytes were writtenon success. Optional.
    928928 */
    929 int SharedClipboardURIObjectWrite(PSHCLURITRANSFER pTransfer,
    930                                   SHCLOBJHANDLE hObj, void *pvBuf, uint32_t cbBuf, uint32_t *pcbWritten,
    931                                   uint32_t fFlags)
     929int SharedClipboardTransferObjectWrite(PSHCLTRANSFER pTransfer,
     930                                       SHCLOBJHANDLE hObj, void *pvBuf, uint32_t cbBuf, uint32_t *pcbWritten,
     931                                       uint32_t fFlags)
    932932{
    933933    AssertPtrReturn(pTransfer, VERR_INVALID_POINTER);
     
    940940    if (pTransfer->State.enmSource == SHCLSOURCE_LOCAL)
    941941    {
    942         PSHCLURIOBJHANDLEINFO pInfo = sharedClipboardURIObjectGet(pTransfer, hObj);
     942        PSHCLOBJHANDLEINFO pInfo = sharedClipboardTransferObjectGet(pTransfer, hObj);
    943943        if (pInfo)
    944944        {
    945945            switch (pInfo->enmType)
    946946            {
    947                 case SHCLURIOBJTYPE_FILE:
     947                case SHCLOBJTYPE_FILE:
    948948                {
    949949                    rc = RTFileWrite(pInfo->u.Local.hFile, pvBuf, cbBuf, (size_t *)pcbWritten);
     
    974974
    975975/**
    976  * Duplicaates an URI object data chunk.
     976 * Duplicaates a transfer object data chunk.
    977977 *
    978978 * @returns Duplicated object data chunk on success, or NULL on failure.
    979  * @param   pDataChunk          URI object data chunk to duplicate.
    980  */
    981 PSHCLOBJDATACHUNK SharedClipboardURIObjectDataChunkDup(PSHCLOBJDATACHUNK pDataChunk)
     979 * @param   pDataChunk          transfer object data chunk to duplicate.
     980 */
     981PSHCLOBJDATACHUNK SharedClipboardTransferObjectDataChunkDup(PSHCLOBJDATACHUNK pDataChunk)
    982982{
    983983    if (!pDataChunk)
     
    10011001
    10021002/**
    1003  * Destroys an URI object data chunk.
    1004  *
    1005  * @param   pDataChunk          URI object data chunk to destroy.
    1006  */
    1007 void SharedClipboardURIObjectDataChunkDestroy(PSHCLOBJDATACHUNK pDataChunk)
     1003 * Destroys a transfer object data chunk.
     1004 *
     1005 * @param   pDataChunk          transfer object data chunk to destroy.
     1006 */
     1007void SharedClipboardTransferObjectDataChunkDestroy(PSHCLOBJDATACHUNK pDataChunk)
    10081008{
    10091009    if (!pDataChunk)
     
    10241024
    10251025/**
    1026  * Frees an URI object data chunk.
    1027  *
    1028  * @param   pDataChunk          URI object data chunk to free. The handed-in pointer will
     1026 * Frees a transfer object data chunk.
     1027 *
     1028 * @param   pDataChunk          transfer object data chunk to free. The handed-in pointer will
    10291029 *                              be invalid after calling this function.
    10301030 */
    1031 void SharedClipboardURIObjectDataChunkFree(PSHCLOBJDATACHUNK pDataChunk)
     1031void SharedClipboardTransferObjectDataChunkFree(PSHCLOBJDATACHUNK pDataChunk)
    10321032{
    10331033    if (!pDataChunk)
    10341034        return;
    10351035
    1036     SharedClipboardURIObjectDataChunkDestroy(pDataChunk);
     1036    SharedClipboardTransferObjectDataChunkDestroy(pDataChunk);
    10371037
    10381038    RTMemFree(pDataChunk);
     
    10411041
    10421042/**
    1043  * Creates an URI clipboard transfer.
    1044  *
    1045  * @returns VBox status code.
    1046  * @param   ppTransfer          Where to return the created URI transfer struct.
    1047  *                              Must be destroyed by SharedClipboardURITransferDestroy().
    1048  */
    1049 int SharedClipboardURITransferCreate(PSHCLURITRANSFER *ppTransfer)
     1043 * Creates an Clipboard transfer.
     1044 *
     1045 * @returns VBox status code.
     1046 * @param   ppTransfer          Where to return the created Shared Clipboard transfer struct.
     1047 *                              Must be destroyed by SharedClipboardTransferDestroy().
     1048 */
     1049int SharedClipboardTransferCreate(PSHCLTRANSFER *ppTransfer)
    10501050{
    10511051    AssertPtrReturn(ppTransfer, VERR_INVALID_POINTER);
     
    10531053    LogFlowFuncEnter();
    10541054
    1055     PSHCLURITRANSFER pTransfer = (PSHCLURITRANSFER)RTMemAlloc(sizeof(SHCLURITRANSFER));
     1055    PSHCLTRANSFER pTransfer = (PSHCLTRANSFER)RTMemAlloc(sizeof(SHCLTRANSFER));
    10561056    if (!pTransfer)
    10571057        return VERR_NO_MEMORY;
     
    10601060
    10611061    pTransfer->State.uID       = 0;
    1062     pTransfer->State.enmStatus = SHCLURITRANSFERSTATUS_NONE;
    1063     pTransfer->State.enmDir    = SHCLURITRANSFERDIR_UNKNOWN;
     1062    pTransfer->State.enmStatus = SHCLTRANSFERSTATUS_NONE;
     1063    pTransfer->State.enmDir    = SHCLTRANSFERDIR_UNKNOWN;
    10641064    pTransfer->State.enmSource = SHCLSOURCE_INVALID;
    10651065
     
    11021102        if (pTransfer)
    11031103        {
    1104             SharedClipboardURITransferDestroy(pTransfer);
     1104            SharedClipboardTransferDestroy(pTransfer);
    11051105            RTMemFree(pTransfer);
    11061106        }
     
    11121112
    11131113/**
    1114  * Destroys an URI clipboard transfer context struct.
    1115  *
    1116  * @returns VBox status code.
    1117  * @param   pURI                URI clipboard transfer to destroy.
    1118  */
    1119 int SharedClipboardURITransferDestroy(PSHCLURITRANSFER pTransfer)
     1114 * Destroys an Clipboard transfer context struct.
     1115 *
     1116 * @returns VBox status code.
     1117 * @param   pTransferCtx                Clipboard transfer to destroy.
     1118 */
     1119int SharedClipboardTransferDestroy(PSHCLTRANSFER pTransfer)
    11201120{
    11211121    if (!pTransfer)
     
    11241124    LogFlowFuncEnter();
    11251125
    1126     int rc = sharedClipboardURITransferThreadDestroy(pTransfer, 30 * 1000 /* Timeout in ms */);
     1126    int rc = sharedClipboardTransferThreadDestroy(pTransfer, 30 * 1000 /* Timeout in ms */);
    11271127    if (RT_FAILURE(rc))
    11281128        return rc;
     
    11321132    SharedClipboardEventSourceDestroy(&pTransfer->Events);
    11331133
    1134     PSHCLURILISTHANDLEINFO pItList, pItListNext;
    1135     RTListForEachSafe(&pTransfer->lstList, pItList, pItListNext, SHCLURILISTHANDLEINFO, Node)
    1136     {
    1137         SharedClipboardURIListHandleInfoDestroy(pItList);
     1134    PSHCLLISTHANDLEINFO pItList, pItListNext;
     1135    RTListForEachSafe(&pTransfer->lstList, pItList, pItListNext, SHCLLISTHANDLEINFO, Node)
     1136    {
     1137        SharedClipboardTransferListHandleInfoDestroy(pItList);
    11381138
    11391139        RTListNodeRemove(&pItList->Node);
     
    11421142    }
    11431143
    1144     PSHCLURIOBJHANDLEINFO pItObj, pItObjNext;
    1145     RTListForEachSafe(&pTransfer->lstObj, pItObj, pItObjNext, SHCLURIOBJHANDLEINFO, Node)
    1146     {
    1147         SharedClipboardURIObjectHandleInfoDestroy(pItObj);
     1144    PSHCLOBJHANDLEINFO pItObj, pItObjNext;
     1145    RTListForEachSafe(&pTransfer->lstObj, pItObj, pItObjNext, SHCLOBJHANDLEINFO, Node)
     1146    {
     1147        SharedClipboardTransferObjectHandleInfoDestroy(pItObj);
    11481148
    11491149        RTListNodeRemove(&pItObj->Node);
     
    11571157
    11581158/**
    1159  * Initializes an URI transfer object.
     1159 * Initializes an Shared Clipboard transfer object.
    11601160 *
    11611161 * @returns VBox status code.
     
    11651165 * @param   enmSource           Specifies the data source of the transfer.
    11661166 */
    1167 int SharedClipboardURITransferInit(PSHCLURITRANSFER pTransfer,
    1168                                    uint32_t uID, SHCLURITRANSFERDIR enmDir, SHCLSOURCE enmSource)
     1167int SharedClipboardTransferInit(PSHCLTRANSFER pTransfer,
     1168                                uint32_t uID, SHCLTRANSFERDIR enmDir, SHCLSOURCE enmSource)
    11691169{
    11701170    pTransfer->State.uID       = uID;
     
    11781178}
    11791179
    1180 int SharedClipboardURITransferOpen(PSHCLURITRANSFER pTransfer)
     1180int SharedClipboardTransferOpen(PSHCLTRANSFER pTransfer)
    11811181{
    11821182    int rc = VINF_SUCCESS;
     
    11891189}
    11901190
    1191 int SharedClipboardURITransferClose(PSHCLURITRANSFER pTransfer)
     1191int SharedClipboardTransferClose(PSHCLTRANSFER pTransfer)
    11921192{
    11931193    int rc = VINF_SUCCESS;
     
    12041204 *
    12051205 * @returns Pointer to list handle info if found, or NULL if not found.
    1206  * @param   pTransfer           URI clipboard transfer to get list handle info from.
     1206 * @param   pTransfer           Clipboard transfer to get list handle info from.
    12071207 * @param   hList               List handle of the list to get handle info for.
    12081208 */
    1209 inline PSHCLURILISTHANDLEINFO sharedClipboardURITransferListGet(PSHCLURITRANSFER pTransfer, SHCLLISTHANDLE hList)
    1210 {
    1211     PSHCLURILISTHANDLEINFO pIt;
    1212     RTListForEach(&pTransfer->lstList, pIt, SHCLURILISTHANDLEINFO, Node)
     1209inline PSHCLLISTHANDLEINFO sharedClipboardTransferListGet(PSHCLTRANSFER pTransfer, SHCLLISTHANDLE hList)
     1210{
     1211    PSHCLLISTHANDLEINFO pIt;
     1212    RTListForEach(&pTransfer->lstList, pIt, SHCLLISTHANDLEINFO, Node)
    12131213    {
    12141214        if (pIt->hList == hList)
     
    12231223 *
    12241224 * @returns New List handle on success, or SHCLLISTHANDLE_INVALID on error.
    1225  * @param   pTransfer           URI clipboard transfer to create new list handle for.
    1226  */
    1227 inline SHCLLISTHANDLE sharedClipboardURITransferListHandleNew(PSHCLURITRANSFER pTransfer)
     1225 * @param   pTransfer           Clipboard transfer to create new list handle for.
     1226 */
     1227inline SHCLLISTHANDLE sharedClipboardTransferListHandleNew(PSHCLTRANSFER pTransfer)
    12281228{
    12291229    return pTransfer->uListHandleNext++; /** @todo Good enough for now. Improve this later. */
     
    12341234 *
    12351235 * @returns VBox status code.
    1236  * @param   pTransfer           URI clipboard transfer to handle.
     1236 * @param   pTransfer           Clipboard transfer to handle.
    12371237 * @param   pOpenParms          List open parameters to use for opening.
    12381238 * @param   phList              Where to store the List handle of opened list on success.
    12391239 */
    1240 int SharedClipboardURITransferListOpen(PSHCLURITRANSFER pTransfer, PSHCLLISTOPENPARMS pOpenParms,
    1241                                        PSHCLLISTHANDLE phList)
     1240int SharedClipboardTransferListOpen(PSHCLTRANSFER pTransfer, PSHCLLISTOPENPARMS pOpenParms,
     1241                                    PSHCLLISTHANDLE phList)
    12421242{
    12431243    AssertPtrReturn(pTransfer,  VERR_INVALID_POINTER);
     
    12511251    if (pTransfer->State.enmSource == SHCLSOURCE_LOCAL)
    12521252    {
    1253         PSHCLURILISTHANDLEINFO pInfo
    1254             = (PSHCLURILISTHANDLEINFO)RTMemAlloc(sizeof(SHCLURILISTHANDLEINFO));
     1253        PSHCLLISTHANDLEINFO pInfo
     1254            = (PSHCLLISTHANDLEINFO)RTMemAlloc(sizeof(SHCLLISTHANDLEINFO));
    12551255        if (pInfo)
    12561256        {
     
    12631263                switch (pInfo->enmType)
    12641264                {
    1265                     case SHCLURIOBJTYPE_DIRECTORY:
     1265                    case SHCLOBJTYPE_DIRECTORY:
    12661266                    {
    12671267                        rc = RTDirOpen(&pInfo->u.Local.hDir, pOpenParms->pszPath);
     
    12691269                    }
    12701270
    1271                     case SHCLURIOBJTYPE_FILE:
     1271                    case SHCLOBJTYPE_FILE:
    12721272                    {
    12731273                        rc = RTFileOpen(&pInfo->u.Local.hFile, pOpenParms->pszPath,
     
    12831283                if (RT_SUCCESS(rc))
    12841284                {
    1285                     pInfo->hList = sharedClipboardURITransferListHandleNew(pTransfer);
     1285                    pInfo->hList = sharedClipboardTransferListHandleNew(pTransfer);
    12861286
    12871287                    RTListAppend(&pTransfer->lstList, &pInfo->Node);
     
    13311331 *
    13321332 * @returns VBox status code.
    1333  * @param   pTransfer           URI clipboard transfer to handle.
     1333 * @param   pTransfer           Clipboard transfer to handle.
    13341334 * @param   hList               Handle of list to close.
    13351335 */
    1336 int SharedClipboardURITransferListClose(PSHCLURITRANSFER pTransfer, SHCLLISTHANDLE hList)
     1336int SharedClipboardTransferListClose(PSHCLTRANSFER pTransfer, SHCLLISTHANDLE hList)
    13371337{
    13381338    AssertPtrReturn(pTransfer, VERR_INVALID_POINTER);
     
    13451345    if (pTransfer->State.enmSource == SHCLSOURCE_LOCAL)
    13461346    {
    1347         PSHCLURILISTHANDLEINFO pInfo = sharedClipboardURITransferListGet(pTransfer, hList);
     1347        PSHCLLISTHANDLEINFO pInfo = sharedClipboardTransferListGet(pTransfer, hList);
    13481348        if (pInfo)
    13491349        {
    13501350            switch (pInfo->enmType)
    13511351            {
    1352                 case SHCLURIOBJTYPE_DIRECTORY:
     1352                case SHCLOBJTYPE_DIRECTORY:
    13531353                {
    13541354                    if (RTDirIsValid(pInfo->u.Local.hDir))
     
    13931393 * @param   pszPath             Path of file to add.
    13941394 */
    1395 static int sharedClipboardURITransferListHdrAddFile(PSHCLLISTHDR pHdr, const char *pszPath)
     1395static int sharedClipboardTransferListHdrAddFile(PSHCLLISTHDR pHdr, const char *pszPath)
    13961396{
    13971397    uint64_t cbSize = 0;
     
    14171417 * @param   cchDstBase          Number of charaters of destination base path.
    14181418 */
    1419 static int sharedClipboardURITransferListHdrFromDir(PSHCLLISTHDR pHdr,
    1420                                                     const char *pcszSrcPath, const char *pcszDstPath,
    1421                                                     const char *pcszDstBase)
     1419static int sharedClipboardTransferListHdrFromDir(PSHCLLISTHDR pHdr,
     1420                                                 const char *pcszSrcPath, const char *pcszDstPath,
     1421                                                 const char *pcszDstBase)
    14221422{
    14231423    AssertPtrReturn(pcszSrcPath, VERR_INVALID_POINTER);
     
    14681468                                if (pszDst)
    14691469                                {
    1470                                     rc = sharedClipboardURITransferListHdrFromDir(pHdr, pszSrc, pszDst,
     1470                                    rc = sharedClipboardTransferListHdrFromDir(pHdr, pszSrc, pszDst,
    14711471                                                                                  pcszDstBase, cchDstBase);
    14721472                                    RTStrFree(pszDst);
     
    14871487                            if (pszSrc)
    14881488                            {
    1489                                 rc = sharedClipboardURITransferListHdrAddFile(pHdr, pszSrc);
     1489                                rc = sharedClipboardTransferListHdrAddFile(pHdr, pszSrc);
    14901490                                RTStrFree(pszSrc);
    14911491                            }
     
    15111511        else if (RTFS_IS_FILE(objInfo.Attr.fMode))
    15121512        {
    1513             rc = sharedClipboardURITransferListHdrAddFile(pHdr, pcszSrcPath);
     1513            rc = sharedClipboardTransferListHdrAddFile(pHdr, pcszSrcPath);
    15141514        }
    15151515        else if (RTFS_IS_SYMLINK(objInfo.Attr.fMode))
     
    15651565 *
    15661566 * @returns VBox status code.
    1567  * @param   pTransfer           URI clipboard transfer to handle.
     1567 * @param   pTransfer           Clipboard transfer to handle.
    15681568 * @param   hList               Handle of list to get header for.
    15691569 * @param   pHdr                Where to store the returned list header information.
    15701570 */
    1571 int SharedClipboardURITransferListGetHeader(PSHCLURITRANSFER pTransfer, SHCLLISTHANDLE hList,
    1572                                             PSHCLLISTHDR pHdr)
     1571int SharedClipboardTransferListGetHeader(PSHCLTRANSFER pTransfer, SHCLLISTHANDLE hList,
     1572                                         PSHCLLISTHDR pHdr)
    15731573{
    15741574    AssertPtrReturn(pTransfer, VERR_INVALID_POINTER);
     
    15811581    if (pTransfer->State.enmSource == SHCLSOURCE_LOCAL)
    15821582    {
    1583         PSHCLURILISTHANDLEINFO pInfo = sharedClipboardURITransferListGet(pTransfer, hList);
     1583        PSHCLLISTHANDLEINFO pInfo = sharedClipboardTransferListGet(pTransfer, hList);
    15841584        if (pInfo)
    15851585        {
    1586             rc = SharedClipboardURIListHdrInit(pHdr);
     1586            rc = SharedClipboardTransferListHdrInit(pHdr);
    15871587            if (RT_SUCCESS(rc))
    15881588            {
    15891589                switch (pInfo->enmType)
    15901590                {
    1591                     case SHCLURIOBJTYPE_DIRECTORY:
     1591                    case SHCLOBJTYPE_DIRECTORY:
    15921592                    {
    15931593                        char *pszPathRel = sharedClipboardPathTranslate(pInfo->pszPathLocalAbs);
    15941594                        if (pszPathRel)
    15951595                        {
    1596                             rc = sharedClipboardURITransferListHdrFromDir(pHdr,
     1596                            rc = sharedClipboardTransferListHdrFromDir(pHdr,
    15971597                                                                          pszPathRel, pszPathRel, pszPathRel);
    15981598                            RTStrFree(pszPathRel);
     
    16031603                    }
    16041604
    1605                     case SHCLURIOBJTYPE_FILE:
     1605                    case SHCLOBJTYPE_FILE:
    16061606                    {
    16071607                        pHdr->cTotalObjects = 1;
     
    16441644
    16451645/**
    1646  * Returns the current URI object for a clipboard URI transfer list.
     1646 * Returns the current transfer object for a clipboard Shared Clipboard transfer list.
    16471647 *
    16481648 * Currently not implemented and wil return NULL.
    16491649 *
    1650  * @returns Pointer to URI object, or NULL if not found / invalid.
    1651  * @param   pTransfer           URI clipboard transfer to return URI object for.
    1652  * @param   hList               Handle of URI transfer list to get object for.
     1650 * @returns Pointer to transfer object, or NULL if not found / invalid.
     1651 * @param   pTransfer           Clipboard transfer to return transfer object for.
     1652 * @param   hList               Handle of Shared Clipboard transfer list to get object for.
    16531653 * @param   uIdx                Index of object to get.
    16541654 */
    1655 PSHCLURITRANSFEROBJ SharedClipboardURITransferListGetObj(PSHCLURITRANSFER pTransfer,
    1656                                                                     SHCLLISTHANDLE hList, uint64_t uIdx)
     1655PSHCLTRANSFEROBJ SharedClipboardTransferListGetObj(PSHCLTRANSFER pTransfer,
     1656                                                   SHCLLISTHANDLE hList, uint64_t uIdx)
    16571657{
    16581658    AssertPtrReturn(pTransfer, NULL);
     
    16691669 *
    16701670 * @returns VBox status code or VERR_NO_MORE_FILES if the end of the list has been reached.
    1671  * @param   pTransfer           URI clipboard transfer to handle.
     1671 * @param   pTransfer           Clipboard transfer to handle.
    16721672 * @param   hList               List handle of list to read from.
    16731673 * @param   pEntry              Where to store the read information.
    16741674 */
    1675 int SharedClipboardURITransferListRead(PSHCLURITRANSFER pTransfer, SHCLLISTHANDLE hList,
    1676                                        PSHCLLISTENTRY pEntry)
     1675int SharedClipboardTransferListRead(PSHCLTRANSFER pTransfer, SHCLLISTHANDLE hList,
     1676                                    PSHCLLISTENTRY pEntry)
    16771677{
    16781678    AssertPtrReturn(pTransfer, VERR_INVALID_POINTER);
     
    16851685    if (pTransfer->State.enmSource == SHCLSOURCE_LOCAL)
    16861686    {
    1687         PSHCLURILISTHANDLEINFO pInfo = sharedClipboardURITransferListGet(pTransfer, hList);
     1687        PSHCLLISTHANDLEINFO pInfo = sharedClipboardTransferListGet(pTransfer, hList);
    16881688        if (pInfo)
    16891689        {
    16901690            switch (pInfo->enmType)
    16911691            {
    1692                 case SHCLURIOBJTYPE_DIRECTORY:
     1692                case SHCLOBJTYPE_DIRECTORY:
    16931693                {
    16941694                    LogFlowFunc(("\tDirectory: %s\n", pInfo->pszPathLocalAbs));
     
    17661766                }
    17671767
    1768                 case SHCLURIOBJTYPE_FILE:
     1768                case SHCLOBJTYPE_FILE:
    17691769                {
    17701770                    LogFlowFunc(("\tSingle file: %s\n", pInfo->pszPathLocalAbs));
     
    18131813}
    18141814
    1815 int SharedClipboardURITransferListWrite(PSHCLURITRANSFER pTransfer, SHCLLISTHANDLE hList,
    1816                                         PSHCLLISTENTRY pEntry)
     1815int SharedClipboardTransferListWrite(PSHCLTRANSFER pTransfer, SHCLLISTHANDLE hList,
     1816                                     PSHCLLISTENTRY pEntry)
    18171817{
    18181818    RT_NOREF(pTransfer, hList, pEntry);
     
    18331833 *
    18341834 * @returns \c true if list handle is valid, \c false if not.
    1835  * @param   pTransfer           URI clipboard transfer to handle.
     1835 * @param   pTransfer           Clipboard transfer to handle.
    18361836 * @param   hList               List handle to check.
    18371837 */
    1838 bool SharedClipboardURITransferListHandleIsValid(PSHCLURITRANSFER pTransfer, SHCLLISTHANDLE hList)
     1838bool SharedClipboardTransferListHandleIsValid(PSHCLTRANSFER pTransfer, SHCLLISTHANDLE hList)
    18391839{
    18401840    bool fIsValid = false;
     
    18421842    if (pTransfer->State.enmSource == SHCLSOURCE_LOCAL)
    18431843    {
    1844         fIsValid = sharedClipboardURITransferListGet(pTransfer, hList) != NULL;
     1844        fIsValid = sharedClipboardTransferListGet(pTransfer, hList) != NULL;
    18451845    }
    18461846    else if (pTransfer->State.enmSource == SHCLSOURCE_REMOTE)
     
    18561856 *
    18571857 * @returns VBox status code.
    1858  * @param   pTransfer           URI clipboard transfer to prepare.
    1859  */
    1860 int SharedClipboardURITransferPrepare(PSHCLURITRANSFER pTransfer)
     1858 * @param   pTransfer           Clipboard transfer to prepare.
     1859 */
     1860int SharedClipboardTransferPrepare(PSHCLTRANSFER pTransfer)
    18611861{
    18621862    AssertPtrReturn(pTransfer, VERR_INVALID_POINTER);
     
    18661866    int rc = VINF_SUCCESS;
    18671867
    1868     AssertMsgReturn(pTransfer->State.enmStatus == SHCLURITRANSFERSTATUS_NONE,
     1868    AssertMsgReturn(pTransfer->State.enmStatus == SHCLTRANSFERSTATUS_NONE,
    18691869                    ("Transfer has wrong state (%RU32)\n", pTransfer->State.enmStatus), VERR_WRONG_ORDER);
    18701870
     
    18731873    if (pTransfer->Callbacks.pfnTransferPrepare)
    18741874    {
    1875         SHCLURITRANSFERCALLBACKDATA callbackData = { pTransfer, pTransfer->Callbacks.pvUser };
     1875        SHCLTRANSFERCALLBACKDATA callbackData = { pTransfer, pTransfer->Callbacks.pvUser };
    18761876        pTransfer->Callbacks.pfnTransferPrepare(&callbackData);
    18771877    }
     
    18791879    if (RT_SUCCESS(rc))
    18801880    {
    1881         pTransfer->State.enmStatus = SHCLURITRANSFERSTATUS_READY;
     1881        pTransfer->State.enmStatus = SHCLTRANSFERSTATUS_READY;
    18821882
    18831883        /** @todo Add checksum support. */
     
    18891889
    18901890/**
    1891  * Sets the URI provider interface for a given transfer.
    1892  *
    1893  * @returns VBox status code.
    1894  * @param   pTransfer           Transfer to create URI provider for.
     1891 * Sets the transfer provider interface for a given transfer.
     1892 *
     1893 * @returns VBox status code.
     1894 * @param   pTransfer           Transfer to create transfer provider for.
    18951895 * @param   pCreationCtx        Provider creation context to use for provider creation.
    18961896 */
    1897 int SharedClipboardURITransferSetInterface(PSHCLURITRANSFER pTransfer,
    1898                                            PSHCLPROVIDERCREATIONCTX pCreationCtx)
     1897int SharedClipboardTransferSetInterface(PSHCLTRANSFER pTransfer,
     1898                                        PSHCLPROVIDERCREATIONCTX pCreationCtx)
    18991899{
    19001900    AssertPtrReturn(pTransfer,    VERR_INVALID_POINTER);
     
    19281928
    19291929/**
    1930  * Clears (resets) the root list of an URI transfer.
    1931  *
    1932  * @param   pTransfer           Transfer to clear URI root list for.
    1933  */
    1934 static void sharedClipboardURIListTransferRootsClear(PSHCLURITRANSFER pTransfer)
     1930 * Clears (resets) the root list of an Shared Clipboard transfer.
     1931 *
     1932 * @param   pTransfer           Transfer to clear transfer root list for.
     1933 */
     1934static void sharedClipboardTransferListTransferRootsClear(PSHCLTRANSFER pTransfer)
    19351935{
    19361936    AssertPtrReturnVoid(pTransfer);
     
    19421942    }
    19431943
    1944     PSHCLURILISTROOT pListRoot, pListRootNext;
    1945     RTListForEachSafe(&pTransfer->lstRoots, pListRoot, pListRootNext, SHCLURILISTROOT, Node)
     1944    PSHCLLISTROOT pListRoot, pListRootNext;
     1945    RTListForEachSafe(&pTransfer->lstRoots, pListRoot, pListRootNext, SHCLLISTROOT, Node)
    19461946    {
    19471947        RTStrFree(pListRoot->pszPathAbs);
     
    19571957
    19581958/**
    1959  * Sets URI root list entries for a given transfer.
    1960  *
    1961  * @returns VBox status code.
    1962  * @param   pTransfer           Transfer to set URI list entries for.
     1959 * Sets transfer root list entries for a given transfer.
     1960 *
     1961 * @returns VBox status code.
     1962 * @param   pTransfer           Transfer to set transfer list entries for.
    19631963 * @param   pszRoots            String list (separated by CRLF) of root entries to set.
    19641964 *                              All entries must have the same root path.
    19651965 * @param   cbRoots             Size (in bytes) of string list.
    19661966 */
    1967 int SharedClipboardURILTransferSetRoots(PSHCLURITRANSFER pTransfer, const char *pszRoots, size_t cbRoots)
     1967int SharedClipboardTransferLTransferSetRoots(PSHCLTRANSFER pTransfer, const char *pszRoots, size_t cbRoots)
    19681968{
    19691969    AssertPtrReturn(pTransfer,      VERR_INVALID_POINTER);
     
    19761976    int rc = VINF_SUCCESS;
    19771977
    1978     sharedClipboardURIListTransferRootsClear(pTransfer);
     1978    sharedClipboardTransferListTransferRootsClear(pTransfer);
    19791979
    19801980    char  *pszPathRootAbs = NULL;
     
    19831983    for (size_t i = 0; i < lstRootEntries.size(); ++i)
    19841984    {
    1985         PSHCLURILISTROOT pListRoot = (PSHCLURILISTROOT)RTMemAlloc(sizeof(SHCLURILISTROOT));
     1985        PSHCLLISTROOT pListRoot = (PSHCLLISTROOT)RTMemAlloc(sizeof(SHCLLISTROOT));
    19861986        AssertPtrBreakStmt(pListRoot, rc = VERR_NO_MEMORY);
    19871987
     
    20292029
    20302030/**
    2031  * Resets an clipboard URI transfer.
    2032  *
    2033  * @param   pTransfer           URI clipboard transfer to reset.
    2034  */
    2035 void SharedClipboardURITransferReset(PSHCLURITRANSFER pTransfer)
     2031 * Resets an clipboard Shared Clipboard transfer.
     2032 *
     2033 * @param   pTransfer           Clipboard transfer to reset.
     2034 */
     2035void SharedClipboardTransferReset(PSHCLTRANSFER pTransfer)
    20362036{
    20372037    AssertPtrReturnVoid(pTransfer);
     
    20392039    LogFlowFuncEnter();
    20402040
    2041     sharedClipboardURIListTransferRootsClear(pTransfer);
    2042 }
    2043 
    2044 /**
    2045  * Returns the clipboard area for a clipboard URI transfer.
     2041    sharedClipboardTransferListTransferRootsClear(pTransfer);
     2042}
     2043
     2044/**
     2045 * Returns the clipboard area for a clipboard Shared Clipboard transfer.
    20462046 *
    20472047 * @returns Current clipboard area, or NULL if none.
    2048  * @param   pTransfer           URI clipboard transfer to return clipboard area for.
    2049  */
    2050 SharedClipboardArea *SharedClipboardURITransferGetArea(PSHCLURITRANSFER pTransfer)
     2048 * @param   pTransfer           Clipboard transfer to return clipboard area for.
     2049 */
     2050SharedClipboardArea *SharedClipboardTransferGetArea(PSHCLTRANSFER pTransfer)
    20512051{
    20522052    AssertPtrReturn(pTransfer, NULL);
     
    20562056
    20572057/**
    2058  * Returns the number of URI root list entries.
     2058 * Returns the number of transfer root list entries.
    20592059 *
    20602060 * @returns Root list entry count.
    2061  * @param   pTransfer           URI clipboard transfer to return root entry count for.
    2062  */
    2063 uint32_t SharedClipboardURILTransferRootsCount(PSHCLURITRANSFER pTransfer)
     2061 * @param   pTransfer           Clipboard transfer to return root entry count for.
     2062 */
     2063uint32_t SharedClipboardTransferLTransferRootsCount(PSHCLTRANSFER pTransfer)
    20642064{
    20652065    AssertPtrReturn(pTransfer, 0);
     
    20722072 *
    20732073 * @returns Pointer to root list entry if found, or NULL if not found.
    2074  * @param   pTransfer           URI clipboard transfer to get root list entry from.
     2074 * @param   pTransfer           Clipboard transfer to get root list entry from.
    20752075 * @param   uIdx                Index of root list entry to return.
    20762076 */
    2077 inline PSHCLURILISTROOT sharedClipboardURILTransferRootsGet(PSHCLURITRANSFER pTransfer, uint32_t uIdx)
     2077inline PSHCLLISTROOT sharedClipboardTransferLTransferRootsGet(PSHCLTRANSFER pTransfer, uint32_t uIdx)
    20782078{
    20792079    if (uIdx >= pTransfer->cRoots)
    20802080        return NULL;
    20812081
    2082     PSHCLURILISTROOT pIt = RTListGetFirst(&pTransfer->lstRoots, SHCLURILISTROOT, Node);
     2082    PSHCLLISTROOT pIt = RTListGetFirst(&pTransfer->lstRoots, SHCLLISTROOT, Node);
    20832083    while (uIdx--)
    2084         pIt = RTListGetNext(&pTransfer->lstRoots, pIt, SHCLURILISTROOT, Node);
     2084        pIt = RTListGetNext(&pTransfer->lstRoots, pIt, SHCLLISTROOT, Node);
    20852085
    20862086    return pIt;
     
    20912091 *
    20922092 * @returns VBox status code.
    2093  * @param   pTransfer           URI clipboard transfer to get root list entry of.
     2093 * @param   pTransfer           Clipboard transfer to get root list entry of.
    20942094 * @param   uIndex              Index (zero-based) of entry to get.
    20952095 * @param   pEntry              Where to store the returned entry on success.
    20962096 */
    2097 int SharedClipboardURILTransferRootsEntry(PSHCLURITRANSFER pTransfer,
    2098                                           uint64_t uIndex, PSHCLROOTLISTENTRY pEntry)
     2097int SharedClipboardTransferLTransferRootsEntry(PSHCLTRANSFER pTransfer,
     2098                                               uint64_t uIndex, PSHCLROOTLISTENTRY pEntry)
    20992099{
    21002100    AssertPtrReturn(pTransfer, VERR_INVALID_POINTER);
     
    21062106    int rc;
    21072107
    2108     PSHCLURILISTROOT pRoot = sharedClipboardURILTransferRootsGet(pTransfer, uIndex);
     2108    PSHCLLISTROOT pRoot = sharedClipboardTransferLTransferRootsGet(pTransfer, uIndex);
    21092109    AssertPtrReturn(pRoot, VERR_INVALID_PARAMETER);
    21102110
     
    21212121        LogFlowFunc(("pcszSrcPath=%s, pszDstPath=%s\n", pcszSrcPath, pszDstPath));
    21222122
    2123         rc = SharedClipboardURIListEntryInit(pEntry);
     2123        rc = SharedClipboardTransferListEntryInit(pEntry);
    21242124        if (RT_SUCCESS(rc))
    21252125        {
     
    21532153
    21542154/**
    2155  * Returns the root entries of an URI transfer.
    2156  *
    2157  * @returns VBox status code.
    2158  * @param   pTransfer           URI clipboard transfer to return root entries for.
     2155 * Returns the root entries of an Shared Clipboard transfer.
     2156 *
     2157 * @returns VBox status code.
     2158 * @param   pTransfer           Clipboard transfer to return root entries for.
    21592159 * @param   ppRootList          Where to store the root list on success.
    21602160 */
    2161 int SharedClipboardURILTransferRootsAsList(PSHCLURITRANSFER pTransfer, PSHCLROOTLIST *ppRootList)
     2161int SharedClipboardTransferLTransferRootsAsList(PSHCLTRANSFER pTransfer, PSHCLROOTLIST *ppRootList)
    21622162{
    21632163    AssertPtrReturn(pTransfer,  VERR_INVALID_POINTER);
     
    21702170    if (pTransfer->State.enmSource == SHCLSOURCE_LOCAL)
    21712171    {
    2172         PSHCLROOTLIST pRootList = SharedClipboardURIRootListAlloc();
     2172        PSHCLROOTLIST pRootList = SharedClipboardTransferRootListAlloc();
    21732173        if (!pRootList)
    21742174            return VERR_NO_MEMORY;
     
    21862186                for (uint64_t i = 0; i < cRoots; ++i)
    21872187                {
    2188                     rc = SharedClipboardURILTransferRootsEntry(pTransfer, i, &paRootListEntries[i]);
     2188                    rc = SharedClipboardTransferLTransferRootsEntry(pTransfer, i, &paRootListEntries[i]);
    21892189                    if (RT_FAILURE(rc))
    21902190                        break;
     
    22242224 *
    22252225 * @returns The transfer's ID.
    2226  * @param   pTransfer           URI clipboard transfer to return ID for.
    2227  */
    2228 SHCLURITRANSFERID SharedClipboardURITransferGetID(PSHCLURITRANSFER pTransfer)
     2226 * @param   pTransfer           Clipboard transfer to return ID for.
     2227 */
     2228SHCLTRANSFERID SharedClipboardTransferGetID(PSHCLTRANSFER pTransfer)
    22292229{
    22302230    AssertPtrReturn(pTransfer, 0);
     
    22372237 *
    22382238 * @returns The transfer's source.
    2239  * @param   pTransfer           URI clipboard transfer to return source for.
    2240  */
    2241 SHCLSOURCE SharedClipboardURITransferGetSource(PSHCLURITRANSFER pTransfer)
     2239 * @param   pTransfer           Clipboard transfer to return source for.
     2240 */
     2241SHCLSOURCE SharedClipboardTransferGetSource(PSHCLTRANSFER pTransfer)
    22422242{
    22432243    AssertPtrReturn(pTransfer, SHCLSOURCE_INVALID);
     
    22502250 *
    22512251 * @returns Current transfer status.
    2252  * @param   pTransfer           URI clipboard transfer to return status for.
    2253  */
    2254 SHCLURITRANSFERSTATUS SharedClipboardURITransferGetStatus(PSHCLURITRANSFER pTransfer)
    2255 {
    2256     AssertPtrReturn(pTransfer, SHCLURITRANSFERSTATUS_NONE);
     2252 * @param   pTransfer           Clipboard transfer to return status for.
     2253 */
     2254SHCLTRANSFERSTATUS SharedClipboardTransferGetStatus(PSHCLTRANSFER pTransfer)
     2255{
     2256    AssertPtrReturn(pTransfer, SHCLTRANSFERSTATUS_NONE);
    22572257
    22582258    return pTransfer->State.enmStatus;
     
    22602260
    22612261/**
    2262  * Runs (starts) an URI transfer thread.
    2263  *
    2264  * @returns VBox status code.
    2265  * @param   pTransfer           URI clipboard transfer to run.
     2262 * Runs (starts) an Shared Clipboard transfer thread.
     2263 *
     2264 * @returns VBox status code.
     2265 * @param   pTransfer           Clipboard transfer to run.
    22662266 * @param   pfnThreadFunc       Pointer to thread function to use.
    22672267 * @param   pvUser              Pointer to user-provided data.
    22682268 */
    2269 int SharedClipboardURITransferRun(PSHCLURITRANSFER pTransfer, PFNRTTHREAD pfnThreadFunc, void *pvUser)
     2269int SharedClipboardTransferRun(PSHCLTRANSFER pTransfer, PFNRTTHREAD pfnThreadFunc, void *pvUser)
    22702270{
    22712271    AssertPtrReturn(pTransfer, VERR_INVALID_POINTER);
    22722272
    2273     AssertMsgReturn(pTransfer->State.enmStatus == SHCLURITRANSFERSTATUS_READY,
     2273    AssertMsgReturn(pTransfer->State.enmStatus == SHCLTRANSFERSTATUS_READY,
    22742274                    ("Wrong status (currently is %RU32)\n", pTransfer->State.enmStatus), VERR_WRONG_ORDER);
    22752275
    2276     int rc = sharedClipboardURITransferThreadCreate(pTransfer, pfnThreadFunc, pvUser);
     2276    int rc = sharedClipboardTransferThreadCreate(pTransfer, pfnThreadFunc, pvUser);
    22772277
    22782278    LogFlowFuncLeaveRC(rc);
     
    22812281
    22822282/**
    2283  * Sets or unsets the callback table to be used for a clipboard URI transfer.
    2284  *
    2285  * @returns VBox status code.
    2286  * @param   pTransfer           URI clipboard transfer to set callbacks for.
     2283 * Sets or unsets the callback table to be used for a clipboard Shared Clipboard transfer.
     2284 *
     2285 * @returns VBox status code.
     2286 * @param   pTransfer           Clipboard transfer to set callbacks for.
    22872287 * @param   pCallbacks          Pointer to callback table to set.
    22882288 */
    2289 void SharedClipboardURITransferSetCallbacks(PSHCLURITRANSFER pTransfer,
    2290                                             PSHCLURITRANSFERCALLBACKS pCallbacks)
     2289void SharedClipboardTransferSetCallbacks(PSHCLTRANSFER pTransfer,
     2290                                         PSHCLTRANSFERCALLBACKS pCallbacks)
    22912291{
    22922292    AssertPtrReturnVoid(pTransfer);
     
    23132313
    23142314/**
    2315  * Creates a thread for a clipboard URI transfer.
    2316  *
    2317  * @returns VBox status code.
    2318  * @param   pTransfer           URI clipboard transfer to create thread for.
     2315 * Creates a thread for a clipboard Shared Clipboard transfer.
     2316 *
     2317 * @returns VBox status code.
     2318 * @param   pTransfer           Clipboard transfer to create thread for.
    23192319 * @param   pfnThreadFunc       Thread function to use for this transfer.
    23202320 * @param   pvUser              Pointer to user-provided data.
    23212321 */
    2322 static int sharedClipboardURITransferThreadCreate(PSHCLURITRANSFER pTransfer, PFNRTTHREAD pfnThreadFunc, void *pvUser)
     2322static int sharedClipboardTransferThreadCreate(PSHCLTRANSFER pTransfer, PFNRTTHREAD pfnThreadFunc, void *pvUser)
    23232323
    23242324{
     
    23362336        if (pTransfer->Thread.fStarted) /* Did the thread indicate that it started correctly? */
    23372337        {
    2338             pTransfer->State.enmStatus = SHCLURITRANSFERSTATUS_STARTED;
     2338            pTransfer->State.enmStatus = SHCLTRANSFERSTATUS_STARTED;
    23392339        }
    23402340        else
     
    23472347
    23482348/**
    2349  * Destroys a thread of a clipboard URI transfer.
    2350  *
    2351  * @returns VBox status code.
    2352  * @param   pTransfer           URI clipboard transfer to destroy thread for.
     2349 * Destroys a thread of a clipboard Shared Clipboard transfer.
     2350 *
     2351 * @returns VBox status code.
     2352 * @param   pTransfer           Clipboard transfer to destroy thread for.
    23532353 * @param   uTimeoutMs          Timeout (in ms) to wait for thread creation.
    23542354 */
    2355 static int sharedClipboardURITransferThreadDestroy(PSHCLURITRANSFER pTransfer, RTMSINTERVAL uTimeoutMs)
     2355static int sharedClipboardTransferThreadDestroy(PSHCLTRANSFER pTransfer, RTMSINTERVAL uTimeoutMs)
    23562356{
    23572357    AssertPtrReturn(pTransfer, VERR_INVALID_POINTER);
     
    23742374
    23752375/**
    2376  * Initializes a clipboard URI transfer.
    2377  *
    2378  * @returns VBox status code.
    2379  * @param   pURI                URI clipboard context to initialize.
    2380  */
    2381 int SharedClipboardURICtxInit(PSHCLURICTX pURI)
    2382 {
    2383     AssertPtrReturn(pURI, VERR_INVALID_POINTER);
    2384 
    2385     LogFlowFunc(("%p\n", pURI));
    2386 
    2387     int rc = RTCritSectInit(&pURI->CritSect);
     2376 * Initializes a clipboard Shared Clipboard transfer.
     2377 *
     2378 * @returns VBox status code.
     2379 * @param   pTransferCtx                Transfer context to initialize.
     2380 */
     2381int SharedClipboardTransferCtxInit(PSHCLTRANSFERCTX pTransferCtx)
     2382{
     2383    AssertPtrReturn(pTransferCtx, VERR_INVALID_POINTER);
     2384
     2385    LogFlowFunc(("%p\n", pTransferCtx));
     2386
     2387    int rc = RTCritSectInit(&pTransferCtx->CritSect);
    23882388    if (RT_SUCCESS(rc))
    23892389    {
    2390         RTListInit(&pURI->List);
    2391 
    2392         pURI->cRunning    = 0;
    2393         pURI->cMaxRunning = UINT16_MAX;
    2394 
    2395         RT_ZERO(pURI->bmTransferIds);
    2396 
    2397         SharedClipboardURICtxReset(pURI);
     2390        RTListInit(&pTransferCtx->List);
     2391
     2392        pTransferCtx->cRunning    = 0;
     2393        pTransferCtx->cMaxRunning = UINT16_MAX;
     2394
     2395        RT_ZERO(pTransferCtx->bmTransferIds);
     2396
     2397        SharedClipboardTransferCtxReset(pTransferCtx);
    23982398    }
    23992399
     
    24022402
    24032403/**
    2404  * Destroys an URI clipboard information context struct.
    2405  *
    2406  * @param   pURI                URI clipboard context to destroy.
    2407  */
    2408 void SharedClipboardURICtxDestroy(PSHCLURICTX pURI)
    2409 {
    2410     AssertPtrReturnVoid(pURI);
    2411 
    2412     LogFlowFunc(("%p\n", pURI));
    2413 
    2414     RTCritSectDelete(&pURI->CritSect);
    2415 
    2416     PSHCLURITRANSFER pTransfer, pTransferNext;
    2417     RTListForEachSafe(&pURI->List, pTransfer, pTransferNext, SHCLURITRANSFER, Node)
    2418     {
    2419         SharedClipboardURITransferDestroy(pTransfer);
     2404 * Destroys an Shared Clipboard transfer context context struct.
     2405 *
     2406 * @param   pTransferCtx                Transfer context to destroy.
     2407 */
     2408void SharedClipboardTransferCtxDestroy(PSHCLTRANSFERCTX pTransferCtx)
     2409{
     2410    AssertPtrReturnVoid(pTransferCtx);
     2411
     2412    LogFlowFunc(("%p\n", pTransferCtx));
     2413
     2414    RTCritSectDelete(&pTransferCtx->CritSect);
     2415
     2416    PSHCLTRANSFER pTransfer, pTransferNext;
     2417    RTListForEachSafe(&pTransferCtx->List, pTransfer, pTransferNext, SHCLTRANSFER, Node)
     2418    {
     2419        SharedClipboardTransferDestroy(pTransfer);
    24202420
    24212421        RTListNodeRemove(&pTransfer->Node);
     
    24252425    }
    24262426
    2427     pURI->cRunning   = 0;
    2428     pURI->cTransfers = 0;
    2429 }
    2430 
    2431 /**
    2432  * Resets an clipboard URI transfer.
    2433  *
    2434  * @param   pURI                URI clipboard context to reset.
    2435  */
    2436 void SharedClipboardURICtxReset(PSHCLURICTX pURI)
    2437 {
    2438     AssertPtrReturnVoid(pURI);
     2427    pTransferCtx->cRunning   = 0;
     2428    pTransferCtx->cTransfers = 0;
     2429}
     2430
     2431/**
     2432 * Resets an clipboard Shared Clipboard transfer.
     2433 *
     2434 * @param   pTransferCtx                Transfer context to reset.
     2435 */
     2436void SharedClipboardTransferCtxReset(PSHCLTRANSFERCTX pTransferCtx)
     2437{
     2438    AssertPtrReturnVoid(pTransferCtx);
    24392439
    24402440    LogFlowFuncEnter();
    24412441
    2442     PSHCLURITRANSFER pTransfer;
    2443     RTListForEach(&pURI->List, pTransfer, SHCLURITRANSFER, Node)
    2444         SharedClipboardURITransferReset(pTransfer);
    2445 }
    2446 
    2447 /**
    2448  * Returns a specific URI transfer, internal version.
    2449  *
    2450  * @returns URI transfer, or NULL if not found.
    2451  * @param   pURI                URI clipboard context to return transfer for.
     2442    PSHCLTRANSFER pTransfer;
     2443    RTListForEach(&pTransferCtx->List, pTransfer, SHCLTRANSFER, Node)
     2444        SharedClipboardTransferReset(pTransfer);
     2445}
     2446
     2447/**
     2448 * Returns a specific Shared Clipboard transfer, internal version.
     2449 *
     2450 * @returns Shared Clipboard transfer, or NULL if not found.
     2451 * @param   pTransferCtx                Transfer context to return transfer for.
    24522452 * @param   uID                 ID of the transfer to return.
    24532453 */
    2454 static PSHCLURITRANSFER sharedClipboardURICtxGetTransferInternal(PSHCLURICTX pURI, uint32_t uID)
    2455 {
    2456     PSHCLURITRANSFER pTransfer;
    2457     RTListForEach(&pURI->List, pTransfer, SHCLURITRANSFER, Node) /** @todo Slow, but works for now. */
     2454static PSHCLTRANSFER sharedClipboardTransferCtxGetTransferInternal(PSHCLTRANSFERCTX pTransferCtx, uint32_t uID)
     2455{
     2456    PSHCLTRANSFER pTransfer;
     2457    RTListForEach(&pTransferCtx->List, pTransfer, SHCLTRANSFER, Node) /** @todo Slow, but works for now. */
    24582458    {
    24592459        if (pTransfer->State.uID == uID)
     
    24652465
    24662466/**
    2467  * Returns a specific URI transfer.
    2468  *
    2469  * @returns URI transfer, or NULL if not found.
    2470  * @param   pURI                URI clipboard context to return transfer for.
     2467 * Returns a specific Shared Clipboard transfer.
     2468 *
     2469 * @returns Shared Clipboard transfer, or NULL if not found.
     2470 * @param   pTransferCtx                Transfer context to return transfer for.
    24712471 * @param   uID                 ID of the transfer to return.
    24722472 */
    2473 PSHCLURITRANSFER SharedClipboardURICtxGetTransfer(PSHCLURICTX pURI, uint32_t uID)
    2474 {
    2475     return sharedClipboardURICtxGetTransferInternal(pURI, uID);
    2476 }
    2477 
    2478 /**
    2479  * Returns the number of running URI transfers.
     2473PSHCLTRANSFER SharedClipboardTransferCtxGetTransfer(PSHCLTRANSFERCTX pTransferCtx, uint32_t uID)
     2474{
     2475    return sharedClipboardTransferCtxGetTransferInternal(pTransferCtx, uID);
     2476}
     2477
     2478/**
     2479 * Returns the number of running Shared Clipboard transfers.
    24802480 *
    24812481 * @returns Number of running transfers.
    2482  * @param   pURI                URI clipboard context to return number for.
    2483  */
    2484 uint32_t SharedClipboardURICtxGetRunningTransfers(PSHCLURICTX pURI)
    2485 {
    2486     AssertPtrReturn(pURI, 0);
    2487     return pURI->cRunning;
    2488 }
    2489 
    2490 /**
    2491  * Returns the number of total URI transfers.
     2482 * @param   pTransferCtx                Transfer context to return number for.
     2483 */
     2484uint32_t SharedClipboardTransferCtxGetRunningTransfers(PSHCLTRANSFERCTX pTransferCtx)
     2485{
     2486    AssertPtrReturn(pTransferCtx, 0);
     2487    return pTransferCtx->cRunning;
     2488}
     2489
     2490/**
     2491 * Returns the number of total Shared Clipboard transfers.
    24922492 *
    24932493 * @returns Number of total transfers.
    2494  * @param   pURI                URI clipboard context to return number for.
    2495  */
    2496 uint32_t SharedClipboardURICtxGetTotalTransfers(PSHCLURICTX pURI)
    2497 {
    2498     AssertPtrReturn(pURI, 0);
    2499     return pURI->cTransfers;
    2500 }
    2501 
    2502 /**
    2503  * Registers an URI transfer with an URI context, i.e. allocates a transfer ID.
     2494 * @param   pTransferCtx                Transfer context to return number for.
     2495 */
     2496uint32_t SharedClipboardTransferCtxGetTotalTransfers(PSHCLTRANSFERCTX pTransferCtx)
     2497{
     2498    AssertPtrReturn(pTransferCtx, 0);
     2499    return pTransferCtx->cTransfers;
     2500}
     2501
     2502/**
     2503 * Registers an Shared Clipboard transfer with a transfer context, i.e. allocates a transfer ID.
    25042504 *
    25052505 * @return  VBox status code.
    25062506 * @retval  VERR_SHCLPB_MAX_TRANSFERS_REACHED if the maximum of concurrent transfers
    25072507 *          is reached.
    2508  * @param   pURI                URI clipboard context to register transfer to.
     2508 * @param   pTransferCtx        Transfer context to register transfer to.
    25092509 * @param   pTransfer           Transfer to register.
    25102510 * @param   pidTransfer         Where to return the transfer ID on success. Optional.
    25112511 */
    2512 int SharedClipboardURICtxTransferRegister(PSHCLURICTX pURI, PSHCLURITRANSFER pTransfer, uint32_t *pidTransfer)
    2513 {
    2514     AssertPtrReturn(pURI,      VERR_INVALID_POINTER);
     2512int SharedClipboardTransferCtxTransferRegister(PSHCLTRANSFERCTX pTransferCtx, PSHCLTRANSFER pTransfer, uint32_t *pidTransfer)
     2513{
     2514    AssertPtrReturn(pTransferCtx,      VERR_INVALID_POINTER);
    25152515    AssertPtrReturn(pTransfer, VERR_INVALID_POINTER);
    25162516    /* pidTransfer is optional. */
     
    25232523    uint32_t idTransfer = RTRandU32Ex(1, VBOX_SHCL_MAX_TRANSFERS - 2);
    25242524
    2525     if (!ASMBitTestAndSet(&pURI->bmTransferIds[0], idTransfer))
     2525    if (!ASMBitTestAndSet(&pTransferCtx->bmTransferIds[0], idTransfer))
    25262526    { /* likely */ }
    2527     else if (pURI->cTransfers < VBOX_SHCL_MAX_TRANSFERS - 2 /* First and last are not used */)
     2527    else if (pTransferCtx->cTransfers < VBOX_SHCL_MAX_TRANSFERS - 2 /* First and last are not used */)
    25282528    {
    25292529        /* Forward search. */
    2530         int iHit = ASMBitNextClear(&pURI->bmTransferIds[0], VBOX_SHCL_MAX_TRANSFERS, idTransfer);
     2530        int iHit = ASMBitNextClear(&pTransferCtx->bmTransferIds[0], VBOX_SHCL_MAX_TRANSFERS, idTransfer);
    25312531        if (iHit < 0)
    2532             iHit = ASMBitFirstClear(&pURI->bmTransferIds[0], VBOX_SHCL_MAX_TRANSFERS);
    2533         AssertLogRelMsgReturn(iHit >= 0, ("Transfer count: %RU16\n", pURI->cTransfers), VERR_SHCLPB_MAX_TRANSFERS_REACHED);
     2532            iHit = ASMBitFirstClear(&pTransferCtx->bmTransferIds[0], VBOX_SHCL_MAX_TRANSFERS);
     2533        AssertLogRelMsgReturn(iHit >= 0, ("Transfer count: %RU16\n", pTransferCtx->cTransfers), VERR_SHCLPB_MAX_TRANSFERS_REACHED);
    25342534        idTransfer = iHit;
    2535         AssertLogRelMsgReturn(!ASMBitTestAndSet(&pURI->bmTransferIds[0], idTransfer), ("idObject=%#x\n", idTransfer), VERR_INTERNAL_ERROR_2);
     2535        AssertLogRelMsgReturn(!ASMBitTestAndSet(&pTransferCtx->bmTransferIds[0], idTransfer), ("idObject=%#x\n", idTransfer), VERR_INTERNAL_ERROR_2);
    25362536    }
    25372537    else
    25382538    {
    2539         LogFunc(("Maximum number of transfers reached (%RU16 transfers)\n", pURI->cTransfers));
     2539        LogFunc(("Maximum number of transfers reached (%RU16 transfers)\n", pTransferCtx->cTransfers));
    25402540        return VERR_SHCLPB_MAX_TRANSFERS_REACHED;
    25412541    }
    25422542
    2543     Log2Func(("pTransfer=%p, idTransfer=%RU32 (%RU16 transfers)\n", pTransfer, idTransfer, pURI->cTransfers));
    2544 
    2545     RTListAppend(&pURI->List, &pTransfer->Node);
    2546 
    2547     pURI->cTransfers++;
     2543    Log2Func(("pTransfer=%p, idTransfer=%RU32 (%RU16 transfers)\n", pTransfer, idTransfer, pTransferCtx->cTransfers));
     2544
     2545    RTListAppend(&pTransferCtx->List, &pTransfer->Node);
     2546
     2547    pTransferCtx->cTransfers++;
    25482548
    25492549    if (pidTransfer)
     
    25542554
    25552555/**
    2556  * Registers an URI transfer with an URI context by specifying an ID for the transfer.
     2556 * Registers an Shared Clipboard transfer with a transfer contextby specifying an ID for the transfer.
    25572557 *
    25582558 * @return  VBox status code.
    25592559 * @retval  VERR_ALREADY_EXISTS if a transfer with the given ID already exists.
    25602560 * @retval  VERR_SHCLPB_MAX_TRANSFERS_REACHED if the maximum of concurrent transfers for this context has been reached.
    2561  * @param   pURI                URI clipboard context to register transfer to.
     2561 * @param   pTransferCtx                Transfer context to register transfer to.
    25622562 * @param   pTransfer           Transfer to register.
    25632563 * @param   idTransfer          Transfer ID to use for registration.
    25642564 */
    2565 int SharedClipboardURICtxTransferRegisterByIndex(PSHCLURICTX pURI, PSHCLURITRANSFER pTransfer, uint32_t idTransfer)
    2566 {
    2567     LogFlowFunc(("cTransfers=%RU16, idTransfer=%RU32\n", pURI->cTransfers, idTransfer));
    2568 
    2569     if (pURI->cTransfers < VBOX_SHCL_MAX_TRANSFERS - 2 /* First and last are not used */)
    2570     {
    2571         if (!ASMBitTestAndSet(&pURI->bmTransferIds[0], idTransfer))
    2572         {
    2573             RTListAppend(&pURI->List, &pTransfer->Node);
    2574 
    2575             pURI->cTransfers++;
     2565int SharedClipboardTransferCtxTransferRegisterByIndex(PSHCLTRANSFERCTX pTransferCtx, PSHCLTRANSFER pTransfer, uint32_t idTransfer)
     2566{
     2567    LogFlowFunc(("cTransfers=%RU16, idTransfer=%RU32\n", pTransferCtx->cTransfers, idTransfer));
     2568
     2569    if (pTransferCtx->cTransfers < VBOX_SHCL_MAX_TRANSFERS - 2 /* First and last are not used */)
     2570    {
     2571        if (!ASMBitTestAndSet(&pTransferCtx->bmTransferIds[0], idTransfer))
     2572        {
     2573            RTListAppend(&pTransferCtx->List, &pTransfer->Node);
     2574
     2575            pTransferCtx->cTransfers++;
    25762576            return VINF_SUCCESS;
    25772577        }
     
    25802580    }
    25812581
    2582     LogFunc(("Maximum number of transfers reached (%RU16 transfers)\n", pURI->cTransfers));
     2582    LogFunc(("Maximum number of transfers reached (%RU16 transfers)\n", pTransferCtx->cTransfers));
    25832583    return VERR_SHCLPB_MAX_TRANSFERS_REACHED;
    25842584}
    25852585
    25862586/**
    2587  * Unregisters a transfer from an URI clipboard context.
     2587 * Unregisters a transfer from an Transfer context.
    25882588 *
    25892589 * @retval  VINF_SUCCESS on success.
    25902590 * @retval  VERR_NOT_FOUND if the transfer ID was not found.
    2591  * @param   pURI                URI clipboard context to unregister transfer from.
     2591 * @param   pTransferCtx                Transfer context to unregister transfer from.
    25922592 * @param   idTransfer          Transfer ID to unregister.
    25932593 */
    2594 int SharedClipboardURICtxTransferUnregister(PSHCLURICTX pURI, uint32_t idTransfer)
     2594int SharedClipboardTransferCtxTransferUnregister(PSHCLTRANSFERCTX pTransferCtx, uint32_t idTransfer)
    25952595{
    25962596    int rc = VINF_SUCCESS;
    2597     AssertMsgStmt(ASMBitTestAndClear(&pURI->bmTransferIds, idTransfer), ("idTransfer=%#x\n", idTransfer), rc = VERR_NOT_FOUND);
    2598 
    2599     PSHCLURITRANSFER pTransfer = sharedClipboardURICtxGetTransferInternal(pURI, idTransfer);
     2597    AssertMsgStmt(ASMBitTestAndClear(&pTransferCtx->bmTransferIds, idTransfer), ("idTransfer=%#x\n", idTransfer), rc = VERR_NOT_FOUND);
     2598
     2599    PSHCLTRANSFER pTransfer = sharedClipboardTransferCtxGetTransferInternal(pTransferCtx, idTransfer);
    26002600    if (pTransfer)
    26012601    {
    26022602        RTListNodeRemove(&pTransfer->Node);
    26032603
    2604         Assert(pURI->cTransfers);
    2605         pURI->cTransfers--;
     2604        Assert(pTransferCtx->cTransfers);
     2605        pTransferCtx->cTransfers--;
    26062606    }
    26072607    else
     
    26162616 * This can be due to transfers which only have been announced but not / never being run.
    26172617 *
    2618  * @param   pURI                URI clipboard context to cleanup transfers for.
    2619  */
    2620 void SharedClipboardURICtxTransfersCleanup(PSHCLURICTX pURI)
    2621 {
    2622     AssertPtrReturnVoid(pURI);
    2623 
    2624     LogFlowFunc(("cTransfers=%RU32, cRunning=%RU32\n", pURI->cTransfers, pURI->cRunning));
     2618 * @param   pTransferCtx                Transfer context to cleanup transfers for.
     2619 */
     2620void SharedClipboardTransferCtxTransfersCleanup(PSHCLTRANSFERCTX pTransferCtx)
     2621{
     2622    AssertPtrReturnVoid(pTransferCtx);
     2623
     2624    LogFlowFunc(("cTransfers=%RU32, cRunning=%RU32\n", pTransferCtx->cTransfers, pTransferCtx->cRunning));
    26252625
    26262626    /* Remove all transfers which are not in a running state (e.g. only announced). */
    2627     PSHCLURITRANSFER pTransfer, pTransferNext;
    2628     RTListForEachSafe(&pURI->List, pTransfer, pTransferNext, SHCLURITRANSFER, Node)
    2629     {
    2630         if (SharedClipboardURITransferGetStatus(pTransfer) != SHCLURITRANSFERSTATUS_STARTED)
    2631         {
    2632             SharedClipboardURITransferDestroy(pTransfer);
     2627    PSHCLTRANSFER pTransfer, pTransferNext;
     2628    RTListForEachSafe(&pTransferCtx->List, pTransfer, pTransferNext, SHCLTRANSFER, Node)
     2629    {
     2630        if (SharedClipboardTransferGetStatus(pTransfer) != SHCLTRANSFERSTATUS_STARTED)
     2631        {
     2632            SharedClipboardTransferDestroy(pTransfer);
    26332633            RTListNodeRemove(&pTransfer->Node);
    26342634
     
    26362636            pTransfer = NULL;
    26372637
    2638             Assert(pURI->cTransfers);
    2639             pURI->cTransfers--;
    2640         }
    2641     }
    2642 }
    2643 
    2644 /**
    2645  * Returns whether the maximum of concurrent transfers of a specific URI context has been reached or not.
     2638            Assert(pTransferCtx->cTransfers);
     2639            pTransferCtx->cTransfers--;
     2640        }
     2641    }
     2642}
     2643
     2644/**
     2645 * Returns whether the maximum of concurrent transfers of a specific transfer contexthas been reached or not.
    26462646 *
    26472647 * @returns \c if maximum has been reached, \c false if not.
    2648  * @param   pURI                URI clipboard context to determine value for.
    2649  */
    2650 bool SharedClipboardURICtxTransfersMaximumReached(PSHCLURICTX pURI)
    2651 {
    2652     AssertPtrReturn(pURI, true);
    2653 
    2654     LogFlowFunc(("cRunning=%RU32, cMaxRunning=%RU32\n", pURI->cRunning, pURI->cMaxRunning));
    2655 
    2656     Assert(pURI->cRunning <= pURI->cMaxRunning);
    2657     return pURI->cRunning == pURI->cMaxRunning;
     2648 * @param   pTransferCtx                Transfer context to determine value for.
     2649 */
     2650bool SharedClipboardTransferCtxTransfersMaximumReached(PSHCLTRANSFERCTX pTransferCtx)
     2651{
     2652    AssertPtrReturn(pTransferCtx, true);
     2653
     2654    LogFlowFunc(("cRunning=%RU32, cMaxRunning=%RU32\n", pTransferCtx->cRunning, pTransferCtx->cMaxRunning));
     2655
     2656    Assert(pTransferCtx->cRunning <= pTransferCtx->cMaxRunning);
     2657    return pTransferCtx->cRunning == pTransferCtx->cMaxRunning;
    26582658}
    26592659
     
    29452945
    29462946/**
    2947  * Translates a Shared Clipboard transfer status (SHCLURITRANSFERSTATUS_XXX) into a string.
     2947 * Translates a Shared Clipboard transfer status (SHCLTRANSFERSTATUS_XXX) into a string.
    29482948 *
    29492949 * @returns Transfer status string name.
     
    29542954    switch (uStatus)
    29552955    {
    2956         RT_CASE_RET_STR(SHCLURITRANSFERSTATUS_NONE);
    2957         RT_CASE_RET_STR(SHCLURITRANSFERSTATUS_READY);
    2958         RT_CASE_RET_STR(SHCLURITRANSFERSTATUS_STARTED);
    2959         RT_CASE_RET_STR(SHCLURITRANSFERSTATUS_STOPPED);
    2960         RT_CASE_RET_STR(SHCLURITRANSFERSTATUS_CANCELED);
    2961         RT_CASE_RET_STR(SHCLURITRANSFERSTATUS_KILLED);
    2962         RT_CASE_RET_STR(SHCLURITRANSFERSTATUS_ERROR);
     2956        RT_CASE_RET_STR(SHCLTRANSFERSTATUS_NONE);
     2957        RT_CASE_RET_STR(SHCLTRANSFERSTATUS_READY);
     2958        RT_CASE_RET_STR(SHCLTRANSFERSTATUS_STARTED);
     2959        RT_CASE_RET_STR(SHCLTRANSFERSTATUS_STOPPED);
     2960        RT_CASE_RET_STR(SHCLTRANSFERSTATUS_CANCELED);
     2961        RT_CASE_RET_STR(SHCLTRANSFERSTATUS_KILLED);
     2962        RT_CASE_RET_STR(SHCLTRANSFERSTATUS_ERROR);
    29632963    }
    29642964    return "Unknown";
  • trunk/src/VBox/GuestHost/SharedClipboard/clipboard-win.cpp

    r80849 r80858  
    881881#ifdef VBOX_WITH_SHARED_CLIPBOARD_TRANSFERS
    882882/**
    883  * Creates an URI transfer by announcing URI data (via IDataObject) to Windows.
     883 * Creates an Shared Clipboard transfer by announcing transfer data (via IDataObject) to Windows.
    884884 *
    885885 * This creates the necessary IDataObject + IStream implementations and initiates the actual transfers required for getting
     
    888888 * @returns VBox status code.
    889889 * @param   pWinCtx             Windows context to use.
    890  * @param   pURICtx             URI context to use.
    891  * @param   pTransfer           URI transfer to use.
    892  */
    893 int SharedClipboardWinURITransferCreate(PSHCLWINCTX pWinCtx, PSHCLURITRANSFER pTransfer)
     890 * @param   pTransferCtxCtx             transfer contextto use.
     891 * @param   pTransfer           Shared Clipboard transfer to use.
     892 */
     893int SharedClipboardWinTransferCreate(PSHCLWINCTX pWinCtx, PSHCLTRANSFER pTransfer)
    894894{
    895895    AssertPtrReturn(pTransfer, VERR_INVALID_POINTER);
     
    901901    AssertReturn(pTransfer->pvUser == NULL, VERR_WRONG_ORDER);
    902902
    903     SharedClipboardWinURITransferCtx *pWinURITransferCtx = new SharedClipboardWinURITransferCtx();
     903    SharedClipboardWinTransferCtx *pWinURITransferCtx = new SharedClipboardWinTransferCtx();
    904904    if (pWinURITransferCtx)
    905905    {
    906906        pTransfer->pvUser = pWinURITransferCtx;
    907         pTransfer->cbUser = sizeof(SharedClipboardWinURITransferCtx);
     907        pTransfer->cbUser = sizeof(SharedClipboardWinTransferCtx);
    908908
    909909        pWinURITransferCtx->pDataObj = new SharedClipboardWinDataObject(pTransfer);
     
    971971
    972972/**
    973  * Destroys implementation-specific data for an URI transfer.
     973 * Destroys implementation-specific data for an Shared Clipboard transfer.
    974974 *
    975975 * @param   pWinCtx             Windows context to use.
    976  * @param   pTransfer           URI transfer to create implementation-specific data for.
    977  */
    978 void SharedClipboardWinURITransferDestroy(PSHCLWINCTX pWinCtx, PSHCLURITRANSFER pTransfer)
     976 * @param   pTransfer           Shared Clipboard transfer to create implementation-specific data for.
     977 */
     978void SharedClipboardWinTransferDestroy(PSHCLWINCTX pWinCtx, PSHCLTRANSFER pTransfer)
    979979{
    980980    RT_NOREF(pWinCtx);
     
    987987    if (pTransfer->pvUser)
    988988    {
    989         Assert(pTransfer->cbUser == sizeof(SharedClipboardWinURITransferCtx));
    990         SharedClipboardWinURITransferCtx *pWinURITransferCtx = (SharedClipboardWinURITransferCtx *)pTransfer->pvUser;
     989        Assert(pTransfer->cbUser == sizeof(SharedClipboardWinTransferCtx));
     990        SharedClipboardWinTransferCtx *pWinURITransferCtx = (SharedClipboardWinTransferCtx *)pTransfer->pvUser;
    991991        Assert(pWinURITransferCtx);
    992992
Note: See TracChangeset for help on using the changeset viewer.

© 2025 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette