dlls/ole32/bindctx.c

   1 /***************************************************************************************
   2  *                            BindCtx implementation
   3  *
   4  *  Copyright 1999  Noomen Hamza
   5  *
   6  * This library is free software; you can redistribute it and/or
   7  * modify it under the terms of the GNU Lesser General Public
   8  * License as published by the Free Software Foundation; either
   9  * version 2.1 of the License, or (at your option) any later version.
  10  *
  11  * This library is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14  * Lesser General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Lesser General Public
  17  * License along with this library; if not, write to the Free Software
  18  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  19  ***************************************************************************************/
  20
  21 #include <stdarg.h>
  22 #include <string.h>
  23 #include <assert.h>
  24
  25 #define COBJMACROS
  26
  27 #include "winerror.h"
  28 #include "windef.h"
  29 #include "winbase.h"
  30 #include "wine/unicode.h"
  31 #include "objbase.h"
  32 #include "wine/debug.h"
  33
  34 WINE_DEFAULT_DEBUG_CHANNEL(ole);
  35
  36 /* represent the first size table and it's increment block size */
  37 #define  BLOCK_TAB_SIZE 10
  38 #define  MAX_TAB_SIZE   0xFFFFFFFF
  39
  40 /* data structure of the BindCtx table elements */
  41 typedef struct BindCtxObject{
  42
  43     IUnknown*   pObj; /* point on a bound object */
  44
  45     LPOLESTR  pkeyObj; /* key associated to this bound object */
  46
  47     BYTE regType; /* registration type: 1 if RegisterObjectParam and 0 if RegisterObjectBound */
  48
  49 } BindCtxObject;
  50
  51 /* BindCtx data strucrture */
  52 typedef struct BindCtxImpl{
  53
  54     IBindCtxVtbl *lpVtbl; /* VTable relative to the IBindCtx interface.*/
  55
  56     ULONG ref; /* reference counter for this object */
  57
  58     BindCtxObject* bindCtxTable; /* this is a table in which all bounded objects are stored*/
  59     DWORD          bindCtxTableLastIndex;  /* first free index in the table */
  60     DWORD          bindCtxTableSize;   /* size table */
  61
  62     BIND_OPTS2 bindOption2; /* a structure which contains the bind options*/
  63
  64 } BindCtxImpl;
  65
  66 /* IBindCtx prototype functions : */
  67
  68 /* IUnknown functions*/
  69 static HRESULT WINAPI BindCtxImpl_QueryInterface(IBindCtx* iface,REFIID riid,void** ppvObject);
  70 static ULONG   WINAPI BindCtxImpl_AddRef(IBindCtx* iface);
  71 static ULONG   WINAPI BindCtxImpl_Release(IBindCtx* iface);
  72 /* IBindCtx functions */
  73 static HRESULT WINAPI BindCtxImpl_RegisterObjectBound(IBindCtx* iface,IUnknown* punk);
  74 static HRESULT WINAPI BindCtxImpl_RevokeObjectBound(IBindCtx* iface, IUnknown* punk);
  75 static HRESULT WINAPI BindCtxImpl_ReleaseBoundObjects(IBindCtx* iface);
  76 static HRESULT WINAPI BindCtxImpl_SetBindOptions(IBindCtx* iface,BIND_OPTS *pbindopts);
  77 static HRESULT WINAPI BindCtxImpl_GetBindOptions(IBindCtx* iface,BIND_OPTS *pbindopts);
  78 static HRESULT WINAPI BindCtxImpl_GetRunningObjectTable(IBindCtx* iface,IRunningObjectTable** pprot);
  79 static HRESULT WINAPI BindCtxImpl_RegisterObjectParam(IBindCtx* iface,LPOLESTR pszkey, IUnknown* punk);
  80 static HRESULT WINAPI BindCtxImpl_GetObjectParam(IBindCtx* iface,LPOLESTR pszkey, IUnknown** punk);
  81 static HRESULT WINAPI BindCtxImpl_EnumObjectParam(IBindCtx* iface,IEnumString** ppenum);
  82 static HRESULT WINAPI BindCtxImpl_RevokeObjectParam(IBindCtx* iface,LPOLESTR pszkey);
  83 /* Local functions*/
  84 HRESULT WINAPI BindCtxImpl_Construct(BindCtxImpl* This);
  85 HRESULT WINAPI BindCtxImpl_Destroy(BindCtxImpl* This);
  86 HRESULT WINAPI BindCtxImpl_GetObjectIndex(BindCtxImpl* This,IUnknown* punk,LPOLESTR pszkey,DWORD *index);
  87
  88 /* Virtual function table for the BindCtx class. */
  89 static IBindCtxVtbl VT_BindCtxImpl =
  90     {
  91     BindCtxImpl_QueryInterface,
  92     BindCtxImpl_AddRef,
  93     BindCtxImpl_Release,
  94     BindCtxImpl_RegisterObjectBound,
  95     BindCtxImpl_RevokeObjectBound,
  96     BindCtxImpl_ReleaseBoundObjects,
  97     BindCtxImpl_SetBindOptions,
  98     BindCtxImpl_GetBindOptions,
  99     BindCtxImpl_GetRunningObjectTable,
 100     BindCtxImpl_RegisterObjectParam,
 101     BindCtxImpl_GetObjectParam,
 102     BindCtxImpl_EnumObjectParam,
 103     BindCtxImpl_RevokeObjectParam
 104 };
 105
 106 /*******************************************************************************
 107  *        BindCtx_QueryInterface
 108  *******************************************************************************/
 109 HRESULT WINAPI BindCtxImpl_QueryInterface(IBindCtx* iface,REFIID riid,void** ppvObject)
 110 {
 111   BindCtxImpl *This = (BindCtxImpl *)iface;
 112
 113   TRACE("(%p,%p,%p)\n",This,riid,ppvObject);
 114
 115   /* Perform a sanity check on the parameters.*/
 116   if ( (This==0) || (ppvObject==0) )
 117       return E_INVALIDARG;
 118
 119   /* Initialize the return parameter.*/
 120   *ppvObject = 0;
 121
 122   /* Compare the riid with the interface IDs implemented by this object.*/
 123   if (IsEqualIID(&IID_IUnknown, riid))
 124       *ppvObject = (IBindCtx*)This;
 125   else
 126       if (IsEqualIID(&IID_IBindCtx, riid))
 127           *ppvObject = (IBindCtx*)This;
 128
 129   /* Check that we obtained an interface.*/
 130   if ((*ppvObject)==0)
 131       return E_NOINTERFACE;
 132
 133    /* Query Interface always increases the reference count by one when it is successful */
 134   BindCtxImpl_AddRef(iface);
 135
 136   return S_OK;
 137 }
 138
 139 /******************************************************************************
 140  *       BindCtx_AddRef
 141  ******************************************************************************/
 142 ULONG WINAPI BindCtxImpl_AddRef(IBindCtx* iface)
 143 {
 144     BindCtxImpl *This = (BindCtxImpl *)iface;
 145
 146     TRACE("(%p)\n",This);
 147
 148     return InterlockedIncrement(&This->ref);
 149 }
 150
 151 /******************************************************************************
 152  *        BindCtx_Release
 153  ******************************************************************************/
 154 ULONG WINAPI BindCtxImpl_Release(IBindCtx* iface)
 155 {
 156     BindCtxImpl *This = (BindCtxImpl *)iface;
 157     ULONG ref;
 158
 159     TRACE("(%p)\n",This);
 160
 161     ref = InterlockedDecrement(&This->ref);
 162
 163     if (ref == 0){
 164         /* release all registered objects */
 165         BindCtxImpl_ReleaseBoundObjects((IBindCtx*)This);
 166
 167         BindCtxImpl_Destroy(This);
 168     }
 169     return ref;
 170 }
 171
 172
 173 /******************************************************************************
 174  *         BindCtx_Construct (local function)
 175  *******************************************************************************/
 176 HRESULT WINAPI BindCtxImpl_Construct(BindCtxImpl* This)
 177 {
 178     TRACE("(%p)\n",This);
 179
 180     /* Initialize the virtual function table.*/
 181     This->lpVtbl       = &VT_BindCtxImpl;
 182     This->ref          = 0;
 183
 184     /* Initialize the BIND_OPTS2 structure */
 185     This->bindOption2.cbStruct  = sizeof(BIND_OPTS2);
 186     This->bindOption2.grfFlags = 0;
 187     This->bindOption2.grfMode = STGM_READWRITE;
 188     This->bindOption2.dwTickCountDeadline = 0;
 189
 190     This->bindOption2.dwTrackFlags = 0;
 191     This->bindOption2.dwClassContext = CLSCTX_SERVER;
 192     This->bindOption2.locale = 1033;
 193     This->bindOption2.pServerInfo = 0;
 194
 195     /* Initialize the bindctx table */
 196     This->bindCtxTableSize=BLOCK_TAB_SIZE;
 197     This->bindCtxTableLastIndex=0;
 198     This->bindCtxTable= HeapAlloc(GetProcessHeap(), 0,This->bindCtxTableSize*sizeof(BindCtxObject));
 199
 200     if (This->bindCtxTable==NULL)
 201         return E_OUTOFMEMORY;
 202
 203     return S_OK;
 204 }
 205
 206 /******************************************************************************
 207  *        BindCtx_Destroy    (local function)
 208  *******************************************************************************/
 209 HRESULT WINAPI BindCtxImpl_Destroy(BindCtxImpl* This)
 210 {
 211     TRACE("(%p)\n",This);
 212
 213     /* free the table space memory */
 214     HeapFree(GetProcessHeap(),0,This->bindCtxTable);
 215
 216     /* free the bindctx structure */
 217     HeapFree(GetProcessHeap(),0,This);
 218
 219     return S_OK;
 220 }
 221
 222
 223 /******************************************************************************
 224  *        BindCtx_RegisterObjectBound
 225  ******************************************************************************/
 226 HRESULT WINAPI BindCtxImpl_RegisterObjectBound(IBindCtx* iface,IUnknown* punk)
 227 {
 228     BindCtxImpl *This = (BindCtxImpl *)iface;
 229     DWORD lastIndex=This->bindCtxTableLastIndex;
 230
 231     TRACE("(%p,%p)\n",This,punk);
 232
 233     if (punk==NULL)
 234         return E_POINTER;
 235
 236     IUnknown_AddRef(punk);
 237
 238     /* put the object in the first free element in the table */
 239     This->bindCtxTable[lastIndex].pObj = punk;
 240     This->bindCtxTable[lastIndex].pkeyObj = NULL;
 241     This->bindCtxTable[lastIndex].regType = 0;
 242     lastIndex= ++This->bindCtxTableLastIndex;
 243
 244     if (lastIndex == This->bindCtxTableSize){ /* the table is full so it must be resized */
 245
 246         if (This->bindCtxTableSize > (MAX_TAB_SIZE-BLOCK_TAB_SIZE)){
 247             FIXME("This->bindCtxTableSize: %ld is out of data limite \n",This->bindCtxTableSize);
 248             return E_FAIL;
 249         }
 250
 251         This->bindCtxTableSize+=BLOCK_TAB_SIZE; /* new table size */
 252
 253         This->bindCtxTable = HeapReAlloc(GetProcessHeap(),HEAP_ZERO_MEMORY,This->bindCtxTable,
 254                                          This->bindCtxTableSize * sizeof(BindCtxObject));
 255         if (!This->bindCtxTable)
 256             return E_OUTOFMEMORY;
 257     }
 258     return S_OK;
 259 }
 260
 261 /******************************************************************************
 262  *        BindCtx_RevokeObjectBound
 263  ******************************************************************************/
 264 HRESULT WINAPI BindCtxImpl_RevokeObjectBound(IBindCtx* iface, IUnknown* punk)
 265 {
 266     DWORD index,j;
 267
 268     BindCtxImpl *This = (BindCtxImpl *)iface;
 269
 270     TRACE("(%p,%p)\n",This,punk);
 271
 272     /* check if the object was registered or not */
 273     if (BindCtxImpl_GetObjectIndex(This,punk,NULL,&index)==S_FALSE)
 274         return MK_E_NOTBOUND;
 275
 276     if(This->bindCtxTable[index].pObj)
 277         IUnknown_Release(This->bindCtxTable[index].pObj);
 278     HeapFree(GetProcessHeap(),0,This->bindCtxTable[index].pkeyObj);
 279
 280     /* left-shift all elements in the right side of the current revoked object */
 281     for(j=index; j<This->bindCtxTableLastIndex-1; j++)
 282         This->bindCtxTable[j]= This->bindCtxTable[j+1];
 283
 284     This->bindCtxTableLastIndex--;
 285
 286     return S_OK;
 287 }
 288
 289 /******************************************************************************
 290  *        BindCtx_ReleaseBoundObjects
 291  ******************************************************************************/
 292 HRESULT WINAPI BindCtxImpl_ReleaseBoundObjects(IBindCtx* iface)
 293 {
 294     DWORD i;
 295
 296     BindCtxImpl *This = (BindCtxImpl *)iface;
 297
 298     TRACE("(%p)\n",This);
 299
 300     for(i=0;i<This->bindCtxTableLastIndex;i++)
 301     {
 302         if(This->bindCtxTable[i].pObj)
 303             IUnknown_Release(This->bindCtxTable[i].pObj);
 304         if(This->bindCtxTable[i].pkeyObj)
 305             HeapFree(GetProcessHeap(),0,This->bindCtxTable[i].pkeyObj);
 306     }
 307
 308     This->bindCtxTableLastIndex = 0;
 309
 310     return S_OK;
 311 }
 312
 313 /******************************************************************************
 314  *        BindCtx_SetBindOptions
 315  ******************************************************************************/
 316 HRESULT WINAPI BindCtxImpl_SetBindOptions(IBindCtx* iface,BIND_OPTS *pbindopts)
 317 {
 318     BindCtxImpl *This = (BindCtxImpl *)iface;
 319
 320     TRACE("(%p,%p)\n",This,pbindopts);
 321
 322     if (pbindopts==NULL)
 323         return E_POINTER;
 324
 325     if (pbindopts->cbStruct > sizeof(BIND_OPTS2))
 326     {
 327         WARN("invalid size\n");
 328         return E_INVALIDARG; /* FIXME : not verified */
 329     }
 330     memcpy(&This->bindOption2, pbindopts, pbindopts->cbStruct);
 331     return S_OK;
 332 }
 333
 334 /******************************************************************************
 335  *        BindCtx_GetBindOptions
 336  ******************************************************************************/
 337 HRESULT WINAPI BindCtxImpl_GetBindOptions(IBindCtx* iface,BIND_OPTS *pbindopts)
 338 {
 339     BindCtxImpl *This = (BindCtxImpl *)iface;
 340
 341     TRACE("(%p,%p)\n",This,pbindopts);
 342
 343     if (pbindopts==NULL)
 344         return E_POINTER;
 345
 346     if (pbindopts->cbStruct > sizeof(BIND_OPTS2))
 347     {
 348         WARN("invalid size\n");
 349         return E_INVALIDARG; /* FIXME : not verified */
 350     }
 351     memcpy(pbindopts, &This->bindOption2, pbindopts->cbStruct);
 352     return S_OK;
 353 }
 354
 355 /******************************************************************************
 356  *        BindCtx_GetRunningObjectTable
 357  ******************************************************************************/
 358 HRESULT WINAPI BindCtxImpl_GetRunningObjectTable(IBindCtx* iface,IRunningObjectTable** pprot)
 359 {
 360     HRESULT res;
 361
 362     BindCtxImpl *This = (BindCtxImpl *)iface;
 363
 364     TRACE("(%p,%p)\n",This,pprot);
 365
 366     if (pprot==NULL)
 367         return E_POINTER;
 368
 369     res=GetRunningObjectTable(0, pprot);
 370
 371     return res;
 372 }
 373
 374 /******************************************************************************
 375  *        BindCtx_RegisterObjectParam
 376  ******************************************************************************/
 377 HRESULT WINAPI BindCtxImpl_RegisterObjectParam(IBindCtx* iface,LPOLESTR pszkey, IUnknown* punk)
 378 {
 379     DWORD index=0;
 380     BindCtxImpl *This = (BindCtxImpl *)iface;
 381
 382     TRACE("(%p,%s,%p)\n",This,debugstr_w(pszkey),punk);
 383
 384     if (punk==NULL)
 385         return E_INVALIDARG;
 386
 387     if (pszkey!=NULL && BindCtxImpl_GetObjectIndex(This,NULL,pszkey,&index)==S_OK)
 388     {
 389         TRACE("Overwriting existing key\n");
 390         if(This->bindCtxTable[index].pObj!=NULL)
 391             IUnknown_Release(This->bindCtxTable[index].pObj);
 392         This->bindCtxTable[index].pObj=punk;
 393         IUnknown_AddRef(punk);
 394         return S_OK;
 395     }
 396     This->bindCtxTable[This->bindCtxTableLastIndex].pObj = punk;
 397     This->bindCtxTable[This->bindCtxTableLastIndex].regType = 1;
 398
 399     if (pszkey==NULL)
 400
 401         This->bindCtxTable[This->bindCtxTableLastIndex].pkeyObj=NULL;
 402
 403     else{
 404
 405         This->bindCtxTable[This->bindCtxTableLastIndex].pkeyObj=
 406             HeapAlloc(GetProcessHeap(),0,(sizeof(WCHAR)*(1+lstrlenW(pszkey))));
 407
 408         if (This->bindCtxTable[This->bindCtxTableLastIndex].pkeyObj==NULL)
 409             return E_OUTOFMEMORY;
 410         strcpyW(This->bindCtxTable[This->bindCtxTableLastIndex].pkeyObj,pszkey);
 411     }
 412
 413     This->bindCtxTableLastIndex++;
 414
 415     if (This->bindCtxTableLastIndex == This->bindCtxTableSize){ /* table is full ! must be resized */
 416
 417         This->bindCtxTableSize+=BLOCK_TAB_SIZE; /* new table size */
 418
 419         if (This->bindCtxTableSize > (MAX_TAB_SIZE-BLOCK_TAB_SIZE)){
 420             FIXME("This->bindCtxTableSize: %ld is out of data limite \n",This->bindCtxTableSize);
 421             return E_FAIL;
 422         }
 423         This->bindCtxTable = HeapReAlloc(GetProcessHeap(),HEAP_ZERO_MEMORY,This->bindCtxTable,
 424                                          This->bindCtxTableSize * sizeof(BindCtxObject));
 425         if (!This->bindCtxTable)
 426             return E_OUTOFMEMORY;
 427     }
 428     IUnknown_AddRef(punk);
 429     return S_OK;
 430 }
 431
 432 /******************************************************************************
 433  *        BindCtx_GetObjectParam
 434  ******************************************************************************/
 435 HRESULT WINAPI BindCtxImpl_GetObjectParam(IBindCtx* iface,LPOLESTR pszkey, IUnknown** punk)
 436 {
 437     DWORD index;
 438     BindCtxImpl *This = (BindCtxImpl *)iface;
 439
 440     TRACE("(%p,%s,%p)\n",This,debugstr_w(pszkey),punk);
 441
 442     if (punk==NULL)
 443         return E_POINTER;
 444
 445     *punk=0;
 446
 447     if (BindCtxImpl_GetObjectIndex(This,NULL,pszkey,&index)==S_FALSE)
 448         return E_FAIL;
 449
 450     IUnknown_AddRef(This->bindCtxTable[index].pObj);
 451
 452     *punk = This->bindCtxTable[index].pObj;
 453
 454     return S_OK;
 455 }
 456
 457 /******************************************************************************
 458  *        BindCtx_RevokeObjectParam
 459  ******************************************************************************/
 460 HRESULT WINAPI BindCtxImpl_RevokeObjectParam(IBindCtx* iface,LPOLESTR ppenum)
 461 {
 462     DWORD index,j;
 463
 464     BindCtxImpl *This = (BindCtxImpl *)iface;
 465
 466     TRACE("(%p,%s)\n",This,debugstr_w(ppenum));
 467
 468     if (BindCtxImpl_GetObjectIndex(This,NULL,ppenum,&index)==S_FALSE)
 469         return E_FAIL;
 470
 471     /* release the object if it's found */
 472     if(This->bindCtxTable[index].pObj)
 473         IUnknown_Release(This->bindCtxTable[index].pObj);
 474     HeapFree(GetProcessHeap(),0,This->bindCtxTable[index].pkeyObj);
 475
 476     /* remove the object from the table with a left-shifting of all objects in the right side */
 477     for(j=index; j<This->bindCtxTableLastIndex-1; j++)
 478         This->bindCtxTable[j]= This->bindCtxTable[j+1];
 479
 480     This->bindCtxTableLastIndex--;
 481
 482     return S_OK;
 483 }
 484
 485 /******************************************************************************
 486  *        BindCtx_EnumObjectParam
 487  ******************************************************************************/
 488 HRESULT WINAPI BindCtxImpl_EnumObjectParam(IBindCtx* iface,IEnumString** pszkey)
 489 {
 490     FIXME("(%p,%p),stub!\n",iface,pszkey);
 491     return E_NOTIMPL;
 492 }
 493
 494 /********************************************************************************
 495  *        GetObjectIndex (local function)
 496  ********************************************************************************/
 497 HRESULT WINAPI BindCtxImpl_GetObjectIndex(BindCtxImpl* This,
 498                                           IUnknown* punk,
 499                                           LPOLESTR pszkey,
 500                                           DWORD *index)
 501 {
 502
 503     DWORD i;
 504     BYTE found=0;
 505
 506     TRACE("(%p,%p,%p,%p)\n",This,punk,pszkey,index);
 507
 508     if (punk==NULL)
 509         /* search object identified by a register key */
 510         for(i=0; ( (i<This->bindCtxTableLastIndex) && (!found));i++){
 511
 512             if(This->bindCtxTable[i].regType==1){
 513
 514                 if ( ( (This->bindCtxTable[i].pkeyObj==NULL) && (pszkey==NULL) ) ||
 515                      ( (This->bindCtxTable[i].pkeyObj!=NULL) &&
 516                        (pszkey!=NULL) &&
 517                        (lstrcmpW(This->bindCtxTable[i].pkeyObj,pszkey)==0)
 518                      )
 519                    )
 520
 521                     found=1;
 522             }
 523         }
 524     else
 525         /* search object identified by a moniker*/
 526         for(i=0; ( (i<This->bindCtxTableLastIndex) && (!found));i++)
 527             if(This->bindCtxTable[i].pObj==punk)
 528                 found=1;
 529
 530     if (index != NULL)
 531         *index=i-1;
 532
 533     if (found)
 534         return S_OK;
 535     TRACE("key not found\n");
 536     return S_FALSE;
 537 }
 538
 539 /******************************************************************************
 540  *        CreateBindCtx16
 541  ******************************************************************************/
 542 HRESULT WINAPI CreateBindCtx16(DWORD reserved, LPBC * ppbc)
 543 {
 544     FIXME("(%ld,%p),stub!\n",reserved,ppbc);
 545     return E_NOTIMPL;
 546 }
 547
 548 /******************************************************************************
 549  *        CreateBindCtx (OLE32.@)
 550  ******************************************************************************/
 551 HRESULT WINAPI CreateBindCtx(DWORD reserved, LPBC * ppbc)
 552 {
 553     BindCtxImpl* newBindCtx = 0;
 554     HRESULT hr;
 555     IID riid=IID_IBindCtx;
 556
 557     TRACE("(%ld,%p)\n",reserved,ppbc);
 558
 559     newBindCtx = HeapAlloc(GetProcessHeap(), 0, sizeof(BindCtxImpl));
 560
 561     if (newBindCtx == 0)
 562         return E_OUTOFMEMORY;
 563
 564     hr = BindCtxImpl_Construct(newBindCtx);
 565
 566     if (FAILED(hr)){
 567
 568         HeapFree(GetProcessHeap(),0,newBindCtx);
 569         return hr;
 570     }
 571
 572     hr = BindCtxImpl_QueryInterface((IBindCtx*)newBindCtx,&riid,(void**)ppbc);
 573
 574     return hr;
 575 }
 576
 577 HRESULT WINAPI BindMoniker(LPMONIKER pmk, DWORD grfOpt, REFIID riid, LPVOID * ppvResult)
 578 {
 579     HRESULT res;
 580     IBindCtx * pbc;
 581
 582     TRACE("(%p, %lx, %s, %p)\n", pmk, grfOpt, debugstr_guid(riid), ppvResult);
 583
 584     res = CreateBindCtx(grfOpt, &pbc);
 585     if (SUCCEEDED(res))
 586         res = IMoniker_BindToObject(pmk, pbc, NULL, riid, ppvResult);
 587     return res;
 588 }