git.oblomov.eu Git - wine/blob - dlls/ole32/stg_stream.c

   1 /*
   2  * Compound Storage (32 bit version)
   3  * Stream implementation
   4  *
   5  * This file contains the implementation of the stream interface
   6  * for streams contained in a compound storage.
   7  *
   8  * Copyright 1999 Francis Beaudet
   9  * Copyright 1999 Thuy Nguyen
  10  */
  11 #include <assert.h>
  12 #include <stdlib.h>
  13 #include <stdio.h>
  14 #include <string.h>
  15
  16 #include "winbase.h"
  17 #include "winerror.h"
  18 #include "ntddk.h"
  19 #include "debugtools.h"
  20
  21 #include "storage32.h"
  22
  23 DEFAULT_DEBUG_CHANNEL(storage);
  24
  25
  26 /*
  27  * Virtual function table for the StgStreamImpl class.
  28  */
  29 static ICOM_VTABLE(IStream) StgStreamImpl_Vtbl =
  30 {
  31     ICOM_MSVTABLE_COMPAT_DummyRTTIVALUE
  32     StgStreamImpl_QueryInterface,
  33     StgStreamImpl_AddRef,
  34     StgStreamImpl_Release,
  35     StgStreamImpl_Read,
  36     StgStreamImpl_Write,
  37     StgStreamImpl_Seek,
  38     StgStreamImpl_SetSize,
  39     StgStreamImpl_CopyTo,
  40     StgStreamImpl_Commit,
  41     StgStreamImpl_Revert,
  42     StgStreamImpl_LockRegion,
  43     StgStreamImpl_UnlockRegion,
  44     StgStreamImpl_Stat,
  45     StgStreamImpl_Clone
  46 };
  47
  48 /******************************************************************************
  49 ** StgStreamImpl implementation
  50 */
  51
  52 /***
  53  * This is the constructor for the StgStreamImpl class.
  54  *
  55  * Params:
  56  *    parentStorage - Pointer to the storage that contains the stream to open
  57  *    ownerProperty - Index of the property that points to this stream.
  58  */
  59 StgStreamImpl* StgStreamImpl_Construct(
  60                 StorageBaseImpl* parentStorage,
  61     DWORD            grfMode,
  62     ULONG            ownerProperty)
  63 {
  64   StgStreamImpl* newStream;
  65
  66   newStream = HeapAlloc(GetProcessHeap(), 0, sizeof(StgStreamImpl));
  67
  68   if (newStream!=0)
  69   {
  70     /*
  71      * Set-up the virtual function table and reference count.
  72      */
  73     ICOM_VTBL(newStream) = &StgStreamImpl_Vtbl;
  74     newStream->ref       = 0;
  75
  76     /*
  77      * We want to nail-down the reference to the storage in case the
  78      * stream out-lives the storage in the client application.
  79      */
  80     newStream->parentStorage = parentStorage;
  81     IStorage_AddRef((IStorage*)newStream->parentStorage);
  82
  83     newStream->grfMode = grfMode;
  84     newStream->ownerProperty = ownerProperty;
  85
  86     /*
  87      * Start the stream at the beginning.
  88      */
  89     newStream->currentPosition.s.HighPart = 0;
  90     newStream->currentPosition.s.LowPart = 0;
  91
  92     /*
  93      * Initialize the rest of the data.
  94      */
  95     newStream->streamSize.s.HighPart = 0;
  96     newStream->streamSize.s.LowPart  = 0;
  97     newStream->bigBlockChain       = 0;
  98     newStream->smallBlockChain     = 0;
  99
 100     /*
 101      * Read the size from the property and determine if the blocks forming
 102      * this stream are large or small.
 103      */
 104     StgStreamImpl_OpenBlockChain(newStream);
 105   }
 106
 107   return newStream;
 108 }
 109
 110 /***
 111  * This is the destructor of the StgStreamImpl class.
 112  *
 113  * This method will clean-up all the resources used-up by the given StgStreamImpl
 114  * class. The pointer passed-in to this function will be freed and will not
 115  * be valid anymore.
 116  */
 117 void StgStreamImpl_Destroy(StgStreamImpl* This)
 118 {
 119   TRACE("(%p)\n", This);
 120
 121   /*
 122    * Release the reference we are holding on the parent storage.
 123    */
 124   IStorage_Release((IStorage*)This->parentStorage);
 125   This->parentStorage = 0;
 126
 127   /*
 128    * Make sure we clean-up the block chain stream objects that we were using.
 129    */
 130   if (This->bigBlockChain != 0)
 131   {
 132     BlockChainStream_Destroy(This->bigBlockChain);
 133     This->bigBlockChain = 0;
 134   }
 135
 136   if (This->smallBlockChain != 0)
 137   {
 138     SmallBlockChainStream_Destroy(This->smallBlockChain);
 139     This->smallBlockChain = 0;
 140   }
 141
 142   /*
 143    * Finally, free the memory used-up by the class.
 144    */
 145   HeapFree(GetProcessHeap(), 0, This);
 146 }
 147
 148 /***
 149  * This implements the IUnknown method QueryInterface for this
 150  * class
 151  */
 152 HRESULT WINAPI StgStreamImpl_QueryInterface(
 153                   IStream*     iface,
 154                   REFIID         riid,        /* [in] */
 155                   void**         ppvObject)   /* [iid_is][out] */
 156 {
 157   StgStreamImpl* const This=(StgStreamImpl*)iface;
 158
 159   /*
 160    * Perform a sanity check on the parameters.
 161    */
 162   if (ppvObject==0)
 163     return E_INVALIDARG;
 164
 165   /*
 166    * Initialize the return parameter.
 167    */
 168   *ppvObject = 0;
 169
 170   /*
 171    * Compare the riid with the interface IDs implemented by this object.
 172    */
 173   if (memcmp(&IID_IUnknown, riid, sizeof(IID_IUnknown)) == 0)
 174   {
 175     *ppvObject = (IStream*)This;
 176   }
 177   else if (memcmp(&IID_IStream, riid, sizeof(IID_IStream)) == 0)
 178   {
 179     *ppvObject = (IStream*)This;
 180   }
 181
 182   /*
 183    * Check that we obtained an interface.
 184    */
 185   if ((*ppvObject)==0)
 186     return E_NOINTERFACE;
 187
 188   /*
 189    * Query Interface always increases the reference count by one when it is
 190    * successful
 191    */
 192   StgStreamImpl_AddRef(iface);
 193
 194   return S_OK;;
 195 }
 196
 197 /***
 198  * This implements the IUnknown method AddRef for this
 199  * class
 200  */
 201 ULONG WINAPI StgStreamImpl_AddRef(
 202                 IStream* iface)
 203 {
 204   StgStreamImpl* const This=(StgStreamImpl*)iface;
 205
 206   This->ref++;
 207
 208   return This->ref;
 209 }
 210
 211 /***
 212  * This implements the IUnknown method Release for this
 213  * class
 214  */
 215 ULONG WINAPI StgStreamImpl_Release(
 216                 IStream* iface)
 217 {
 218   StgStreamImpl* const This=(StgStreamImpl*)iface;
 219
 220   ULONG newRef;
 221
 222   This->ref--;
 223
 224   newRef = This->ref;
 225
 226   /*
 227    * If the reference count goes down to 0, perform suicide.
 228    */
 229   if (newRef==0)
 230   {
 231     StgStreamImpl_Destroy(This);
 232   }
 233
 234   return newRef;
 235 }
 236
 237 /***
 238  * This method will open the block chain pointed by the property
 239  * that describes the stream.
 240  * If the stream's size is null, no chain is opened.
 241  */
 242 void StgStreamImpl_OpenBlockChain(
 243         StgStreamImpl* This)
 244 {
 245   StgProperty    curProperty;
 246   BOOL         readSucessful;
 247
 248   /*
 249    * Make sure no old object is staying behind.
 250    */
 251   if (This->smallBlockChain != 0)
 252   {
 253     SmallBlockChainStream_Destroy(This->smallBlockChain);
 254     This->smallBlockChain = 0;
 255   }
 256
 257   if (This->bigBlockChain != 0)
 258   {
 259     BlockChainStream_Destroy(This->bigBlockChain);
 260     This->bigBlockChain = 0;
 261   }
 262
 263   /*
 264    * Read the information from the property.
 265    */
 266   readSucessful = StorageImpl_ReadProperty(This->parentStorage->ancestorStorage,
 267                                              This->ownerProperty,
 268                                              &curProperty);
 269
 270   if (readSucessful)
 271   {
 272     This->streamSize = curProperty.size;
 273
 274     /*
 275      * This code supports only streams that are <32 bits in size.
 276      */
 277     assert(This->streamSize.s.HighPart == 0);
 278
 279     if(curProperty.startingBlock == BLOCK_END_OF_CHAIN)
 280     {
 281       assert( (This->streamSize.s.HighPart == 0) && (This->streamSize.s.LowPart == 0) );
 282     }
 283     else
 284     {
 285       if ( (This->streamSize.s.HighPart == 0) &&
 286            (This->streamSize.s.LowPart < LIMIT_TO_USE_SMALL_BLOCK) )
 287       {
 288         This->smallBlockChain = SmallBlockChainStream_Construct(
 289                                                                 This->parentStorage->ancestorStorage,
 290                                                                 This->ownerProperty);
 291       }
 292       else
 293       {
 294         This->bigBlockChain = BlockChainStream_Construct(
 295                                                          This->parentStorage->ancestorStorage,
 296                                                          NULL,
 297                                                          This->ownerProperty);
 298       }
 299     }
 300   }
 301 }
 302
 303 /***
 304  * This method is part of the ISequentialStream interface.
 305  *
 306  * If reads a block of information from the stream at the current
 307  * position. It then moves the current position at the end of the
 308  * read block
 309  *
 310  * See the documentation of ISequentialStream for more info.
 311  */
 312 HRESULT WINAPI StgStreamImpl_Read(
 313                   IStream*     iface,
 314                   void*          pv,        /* [length_is][size_is][out] */
 315                   ULONG          cb,        /* [in] */
 316                   ULONG*         pcbRead)   /* [out] */
 317 {
 318   StgStreamImpl* const This=(StgStreamImpl*)iface;
 319
 320   ULONG bytesReadBuffer;
 321   ULONG bytesToReadFromBuffer;
 322
 323   TRACE("(%p, %p, %ld, %p)\n",
 324         iface, pv, cb, pcbRead);
 325
 326   /*
 327    * If the caller is not interested in the nubmer of bytes read,
 328    * we use another buffer to avoid "if" statements in the code.
 329    */
 330   if (pcbRead==0)
 331     pcbRead = &bytesReadBuffer;
 332
 333   /*
 334    * Using the known size of the stream, calculate the number of bytes
 335    * to read from the block chain
 336    */
 337   bytesToReadFromBuffer = min( This->streamSize.s.LowPart - This->currentPosition.s.LowPart, cb);
 338
 339   /*
 340    * Depending on the type of chain that was opened when the stream was constructed,
 341    * we delegate the work to the method that read the block chains.
 342    */
 343   if (This->smallBlockChain!=0)
 344   {
 345     SmallBlockChainStream_ReadAt(This->smallBlockChain,
 346                                  This->currentPosition,
 347                                  bytesToReadFromBuffer,
 348                                  pv,
 349                                  pcbRead);
 350
 351   }
 352   else if (This->bigBlockChain!=0)
 353   {
 354     BlockChainStream_ReadAt(This->bigBlockChain,
 355                             This->currentPosition,
 356                             bytesToReadFromBuffer,
 357                             pv,
 358                             pcbRead);
 359   }
 360   else
 361   {
 362     /*
 363      * Small and big block chains are both NULL. This case will happen
 364      * when a stream starts with BLOCK_END_OF_CHAIN and has size zero.
 365      */
 366
 367     *pcbRead = 0;
 368     return S_OK;
 369   }
 370
 371   /*
 372    * We should always be able to read the proper amount of data from the
 373    * chain.
 374    */
 375   assert(bytesToReadFromBuffer == *pcbRead);
 376
 377   /*
 378    * Advance the pointer for the number of positions read.
 379    */
 380   This->currentPosition.s.LowPart += *pcbRead;
 381
 382   /*
 383    * The function returns S_OK if at least one byte could be read.
 384    * FIXME: What should be returned if pcbRead argument is NULL?
 385    */
 386   if (*pcbRead > 0)
 387     return S_OK;
 388
 389   return S_FALSE;
 390 }
 391
 392 /***
 393  * This method is part of the ISequentialStream interface.
 394  *
 395  * It writes a block of information to the stream at the current
 396  * position. It then moves the current position at the end of the
 397  * written block. If the stream is too small to fit the block,
 398  * the stream is grown to fit.
 399  *
 400  * See the documentation of ISequentialStream for more info.
 401  */
 402 HRESULT WINAPI StgStreamImpl_Write(
 403                   IStream*     iface,
 404                   const void*    pv,          /* [size_is][in] */
 405                   ULONG          cb,          /* [in] */
 406                   ULONG*         pcbWritten)  /* [out] */
 407 {
 408   StgStreamImpl* const This=(StgStreamImpl*)iface;
 409
 410   ULARGE_INTEGER newSize;
 411   ULONG bytesWritten = 0;
 412
 413   TRACE("(%p, %p, %ld, %p)\n",
 414         iface, pv, cb, pcbWritten);
 415
 416   /*
 417    * Do we have permission to write to this stream?
 418    */
 419   if (!(This->grfMode & (STGM_WRITE | STGM_READWRITE))) {
 420       return STG_E_ACCESSDENIED;
 421   }
 422
 423   /*
 424    * If the caller is not interested in the number of bytes written,
 425    * we use another buffer to avoid "if" statements in the code.
 426    */
 427   if (pcbWritten == 0)
 428     pcbWritten = &bytesWritten;
 429
 430   /*
 431    * Initialize the out parameter
 432    */
 433   *pcbWritten = 0;
 434
 435   if (cb == 0)
 436   {
 437     return S_OK;
 438   }
 439   else
 440   {
 441     newSize.s.HighPart = 0;
 442     newSize.s.LowPart = This->currentPosition.s.LowPart + cb;
 443   }
 444
 445   /*
 446    * Verify if we need to grow the stream
 447    */
 448   if (newSize.s.LowPart > This->streamSize.s.LowPart)
 449   {
 450     /* grow stream */
 451     IStream_SetSize(iface, newSize);
 452   }
 453
 454   /*
 455    * Depending on the type of chain that was opened when the stream was constructed,
 456    * we delegate the work to the method that readwrites to the block chains.
 457    */
 458   if (This->smallBlockChain!=0)
 459   {
 460     SmallBlockChainStream_WriteAt(This->smallBlockChain,
 461                                   This->currentPosition,
 462                                   cb,
 463                                   pv,
 464                                   pcbWritten);
 465
 466   }
 467   else if (This->bigBlockChain!=0)
 468   {
 469     BlockChainStream_WriteAt(This->bigBlockChain,
 470                              This->currentPosition,
 471                              cb,
 472                              pv,
 473                              pcbWritten);
 474   }
 475   else
 476     assert(FALSE);
 477
 478   /*
 479    * Advance the position pointer for the number of positions written.
 480    */
 481   This->currentPosition.s.LowPart += *pcbWritten;
 482
 483   return S_OK;
 484 }
 485
 486 /***
 487  * This method is part of the IStream interface.
 488  *
 489  * It will move the current stream pointer according to the parameters
 490  * given.
 491  *
 492  * See the documentation of IStream for more info.
 493  */
 494 HRESULT WINAPI StgStreamImpl_Seek(
 495                   IStream*      iface,
 496                   LARGE_INTEGER   dlibMove,         /* [in] */
 497                   DWORD           dwOrigin,         /* [in] */
 498                   ULARGE_INTEGER* plibNewPosition) /* [out] */
 499 {
 500   StgStreamImpl* const This=(StgStreamImpl*)iface;
 501
 502   ULARGE_INTEGER newPosition;
 503
 504   TRACE("(%p, %ld, %ld, %p)\n",
 505         iface, dlibMove.s.LowPart, dwOrigin, plibNewPosition);
 506
 507   /*
 508    * The caller is allowed to pass in NULL as the new position return value.
 509    * If it happens, we assign it to a dynamic variable to avoid special cases
 510    * in the code below.
 511    */
 512   if (plibNewPosition == 0)
 513   {
 514     plibNewPosition = &newPosition;
 515   }
 516
 517   /*
 518    * The file pointer is moved depending on the given "function"
 519    * parameter.
 520    */
 521   switch (dwOrigin)
 522   {
 523     case STREAM_SEEK_SET:
 524       plibNewPosition->s.HighPart = 0;
 525       plibNewPosition->s.LowPart  = 0;
 526       break;
 527     case STREAM_SEEK_CUR:
 528       *plibNewPosition = This->currentPosition;
 529       break;
 530     case STREAM_SEEK_END:
 531       *plibNewPosition = This->streamSize;
 532       break;
 533     default:
 534       return STG_E_INVALIDFUNCTION;
 535   }
 536
 537   plibNewPosition->QuadPart = RtlLargeIntegerAdd( plibNewPosition->QuadPart, dlibMove.QuadPart );
 538
 539   /*
 540    * tell the caller what we calculated
 541    */
 542   This->currentPosition = *plibNewPosition;
 543
 544   return S_OK;
 545 }
 546
 547 /***
 548  * This method is part of the IStream interface.
 549  *
 550  * It will change the size of a stream.
 551  *
 552  * TODO: Switch from small blocks to big blocks and vice versa.
 553  *
 554  * See the documentation of IStream for more info.
 555  */
 556 HRESULT WINAPI StgStreamImpl_SetSize(
 557                                      IStream*      iface,
 558                                      ULARGE_INTEGER  libNewSize)   /* [in] */
 559 {
 560   StgStreamImpl* const This=(StgStreamImpl*)iface;
 561
 562   StgProperty    curProperty;
 563   BOOL         Success;
 564
 565   TRACE("(%p, %ld)\n", iface, libNewSize.s.LowPart);
 566
 567   /*
 568    * As documented.
 569    */
 570   if (libNewSize.s.HighPart != 0)
 571     return STG_E_INVALIDFUNCTION;
 572
 573   /*
 574    * Do we have permission?
 575    */
 576   if (!(This->grfMode & (STGM_WRITE | STGM_READWRITE)))
 577     return STG_E_ACCESSDENIED;
 578
 579   if (This->streamSize.s.LowPart == libNewSize.s.LowPart)
 580     return S_OK;
 581
 582   /*
 583    * This will happen if we're creating a stream
 584    */
 585   if ((This->smallBlockChain == 0) && (This->bigBlockChain == 0))
 586   {
 587     if (libNewSize.s.LowPart < LIMIT_TO_USE_SMALL_BLOCK)
 588     {
 589       This->smallBlockChain = SmallBlockChainStream_Construct(
 590                                     This->parentStorage->ancestorStorage,
 591                                     This->ownerProperty);
 592     }
 593     else
 594     {
 595       This->bigBlockChain = BlockChainStream_Construct(
 596                                 This->parentStorage->ancestorStorage,
 597                                 NULL,
 598                                 This->ownerProperty);
 599     }
 600   }
 601
 602   /*
 603    * Read this stream's property to see if it's small blocks or big blocks
 604    */
 605   Success = StorageImpl_ReadProperty(This->parentStorage->ancestorStorage,
 606                                        This->ownerProperty,
 607                                        &curProperty);
 608   /*
 609    * Determine if we have to switch from small to big blocks or vice versa
 610    */
 611   if ( (This->smallBlockChain!=0) &&
 612        (curProperty.size.s.LowPart < LIMIT_TO_USE_SMALL_BLOCK) )
 613   {
 614     if (libNewSize.s.LowPart >= LIMIT_TO_USE_SMALL_BLOCK)
 615     {
 616       /*
 617        * Transform the small block chain into a big block chain
 618        */
 619       This->bigBlockChain = Storage32Impl_SmallBlocksToBigBlocks(
 620                                 This->parentStorage->ancestorStorage,
 621                                 &This->smallBlockChain);
 622     }
 623   }
 624
 625   if (This->smallBlockChain!=0)
 626   {
 627     Success = SmallBlockChainStream_SetSize(This->smallBlockChain, libNewSize);
 628   }
 629   else
 630   {
 631     Success = BlockChainStream_SetSize(This->bigBlockChain, libNewSize);
 632   }
 633
 634   /*
 635    * Write to the property the new information about this stream
 636    */
 637   Success = StorageImpl_ReadProperty(This->parentStorage->ancestorStorage,
 638                                        This->ownerProperty,
 639                                        &curProperty);
 640
 641   curProperty.size.s.HighPart = libNewSize.s.HighPart;
 642   curProperty.size.s.LowPart = libNewSize.s.LowPart;
 643
 644   if (Success)
 645   {
 646     StorageImpl_WriteProperty(This->parentStorage->ancestorStorage,
 647                                 This->ownerProperty,
 648                                 &curProperty);
 649   }
 650
 651   This->streamSize = libNewSize;
 652
 653   return S_OK;
 654 }
 655
 656 /***
 657  * This method is part of the IStream interface.
 658  *
 659  * It will copy the 'cb' Bytes to 'pstm' IStream.
 660  *
 661  * See the documentation of IStream for more info.
 662  */
 663 HRESULT WINAPI StgStreamImpl_CopyTo(
 664                                     IStream*      iface,
 665                                     IStream*      pstm,         /* [unique][in] */
 666                                     ULARGE_INTEGER  cb,           /* [in] */
 667                                     ULARGE_INTEGER* pcbRead,      /* [out] */
 668                                     ULARGE_INTEGER* pcbWritten)   /* [out] */
 669 {
 670   HRESULT        hr = S_OK;
 671   BYTE           tmpBuffer[128];
 672   ULONG          bytesRead, bytesWritten, copySize;
 673   ULARGE_INTEGER totalBytesRead;
 674   ULARGE_INTEGER totalBytesWritten;
 675
 676   TRACE("(%p, %p, %ld, %p, %p)\n",
 677         iface, pstm, cb.s.LowPart, pcbRead, pcbWritten);
 678
 679   /*
 680    * Sanity check
 681    */
 682   if ( pstm == 0 )
 683     return STG_E_INVALIDPOINTER;
 684
 685   totalBytesRead.s.LowPart = totalBytesRead.s.HighPart = 0;
 686   totalBytesWritten.s.LowPart = totalBytesWritten.s.HighPart = 0;
 687
 688   /*
 689    * use stack to store data temporarly
 690    * there is surely more performant way of doing it, for now this basic
 691    * implementation will do the job
 692    */
 693   while ( cb.s.LowPart > 0 )
 694   {
 695     if ( cb.s.LowPart >= 128 )
 696       copySize = 128;
 697     else
 698       copySize = cb.s.LowPart;
 699
 700     IStream_Read(iface, tmpBuffer, copySize, &bytesRead);
 701
 702     totalBytesRead.s.LowPart += bytesRead;
 703
 704     IStream_Write(pstm, tmpBuffer, bytesRead, &bytesWritten);
 705
 706     totalBytesWritten.s.LowPart += bytesWritten;
 707
 708     /*
 709      * Check that read & write operations were succesfull
 710      */
 711     if (bytesRead != bytesWritten)
 712     {
 713       hr = STG_E_MEDIUMFULL;
 714       break;
 715     }
 716
 717     if (bytesRead!=copySize)
 718       cb.s.LowPart = 0;
 719     else
 720       cb.s.LowPart -= bytesRead;
 721   }
 722
 723   /*
 724    * Update number of bytes read and written
 725    */
 726   if (pcbRead)
 727   {
 728     pcbRead->s.LowPart = totalBytesRead.s.LowPart;
 729     pcbRead->s.HighPart = totalBytesRead.s.HighPart;
 730   }
 731
 732   if (pcbWritten)
 733   {
 734     pcbWritten->s.LowPart = totalBytesWritten.s.LowPart;
 735     pcbWritten->s.HighPart = totalBytesWritten.s.HighPart;
 736   }
 737   return hr;
 738 }
 739
 740 /***
 741  * This method is part of the IStream interface.
 742  *
 743  * For streams contained in structured storages, this method
 744  * does nothing. This is what the documentation tells us.
 745  *
 746  * See the documentation of IStream for more info.
 747  */
 748 HRESULT WINAPI StgStreamImpl_Commit(
 749                   IStream*      iface,
 750                   DWORD           grfCommitFlags)  /* [in] */
 751 {
 752   return S_OK;
 753 }
 754
 755 /***
 756  * This method is part of the IStream interface.
 757  *
 758  * For streams contained in structured storages, this method
 759  * does nothing. This is what the documentation tells us.
 760  *
 761  * See the documentation of IStream for more info.
 762  */
 763 HRESULT WINAPI StgStreamImpl_Revert(
 764                   IStream* iface)
 765 {
 766   return S_OK;
 767 }
 768
 769 HRESULT WINAPI StgStreamImpl_LockRegion(
 770                                         IStream*     iface,
 771                                         ULARGE_INTEGER libOffset,   /* [in] */
 772                                         ULARGE_INTEGER cb,          /* [in] */
 773                                         DWORD          dwLockType)  /* [in] */
 774 {
 775   FIXME("not implemented!\n");
 776   return E_NOTIMPL;
 777 }
 778
 779 HRESULT WINAPI StgStreamImpl_UnlockRegion(
 780                                           IStream*     iface,
 781                                           ULARGE_INTEGER libOffset,   /* [in] */
 782                                           ULARGE_INTEGER cb,          /* [in] */
 783                                           DWORD          dwLockType)  /* [in] */
 784 {
 785   FIXME("not implemented!\n");
 786   return E_NOTIMPL;
 787 }
 788
 789 /***
 790  * This method is part of the IStream interface.
 791  *
 792  * This method returns information about the current
 793  * stream.
 794  *
 795  * See the documentation of IStream for more info.
 796  */
 797 HRESULT WINAPI StgStreamImpl_Stat(
 798                   IStream*     iface,
 799                   STATSTG*       pstatstg,     /* [out] */
 800                   DWORD          grfStatFlag)  /* [in] */
 801 {
 802   StgStreamImpl* const This=(StgStreamImpl*)iface;
 803
 804   StgProperty    curProperty;
 805   BOOL         readSucessful;
 806
 807   /*
 808    * Read the information from the property.
 809    */
 810   readSucessful = StorageImpl_ReadProperty(This->parentStorage->ancestorStorage,
 811                                              This->ownerProperty,
 812                                              &curProperty);
 813
 814   if (readSucessful)
 815   {
 816     StorageUtl_CopyPropertyToSTATSTG(pstatstg,
 817                                      &curProperty,
 818                                      grfStatFlag);
 819
 820     pstatstg->grfMode = This->grfMode;
 821
 822     return S_OK;
 823   }
 824
 825   return E_FAIL;
 826 }
 827
 828 /***
 829  * This method is part of the IStream interface.
 830  *
 831  * This method returns a clone of the interface that allows for
 832  * another seek pointer
 833  *
 834  * See the documentation of IStream for more info.
 835  *
 836  * I am not totally sure what I am doing here but I presume that this
 837  * should be basically as simple as creating a new stream with the same
 838  * parent etc and positioning its seek cursor.
 839  */
 840 HRESULT WINAPI StgStreamImpl_Clone(
 841                                    IStream*     iface,
 842                                    IStream**    ppstm) /* [out] */
 843 {
 844   StgStreamImpl* const This=(StgStreamImpl*)iface;
 845   HRESULT hres;
 846   StgStreamImpl* new_stream;
 847   LARGE_INTEGER seek_pos;
 848
 849   /*
 850    * Sanity check
 851    */
 852   if ( ppstm == 0 )
 853     return STG_E_INVALIDPOINTER;
 854
 855   new_stream = StgStreamImpl_Construct (This->parentStorage, This->grfMode, This->ownerProperty);
 856
 857   if (!new_stream)
 858     return STG_E_INSUFFICIENTMEMORY; /* Currently the only reason for new_stream=0 */
 859
 860   *ppstm = (IStream*) new_stream;
 861   seek_pos.QuadPart = This->currentPosition.QuadPart;
 862
 863   hres=StgStreamImpl_Seek (*ppstm, seek_pos, STREAM_SEEK_SET, NULL);
 864
 865   assert (SUCCEEDED(hres));
 866
 867   return S_OK;
 868 }