regedit: Fix Dutch translation.
[wine] / dlls / ole32 / hglobalstream.c
1 /*
2  * HGLOBAL Stream implementation
3  *
4  * This file contains the implementation of the stream interface
5  * for streams contained supported by an HGLOBAL pointer.
6  *
7  * Copyright 1999 Francis Beaudet
8  *
9  * This library is free software; you can redistribute it and/or
10  * modify it under the terms of the GNU Lesser General Public
11  * License as published by the Free Software Foundation; either
12  * version 2.1 of the License, or (at your option) any later version.
13  *
14  * This library is distributed in the hope that it will be useful,
15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
17  * Lesser General Public License for more details.
18  *
19  * You should have received a copy of the GNU Lesser General Public
20  * License along with this library; if not, write to the Free Software
21  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
22  */
23
24 #include "config.h"
25
26 #include <assert.h>
27 #include <stdlib.h>
28 #include <stdarg.h>
29 #include <stdio.h>
30 #include <string.h>
31
32 #define COBJMACROS
33 #define NONAMELESSUNION
34 #define NONAMELESSSTRUCT
35
36 #include "windef.h"
37 #include "winbase.h"
38 #include "winuser.h"
39 #include "objbase.h"
40 #include "ole2.h"
41 #include "winerror.h"
42 #include "winternl.h"
43
44 #include "wine/debug.h"
45
46 WINE_DEFAULT_DEBUG_CHANNEL(storage);
47
48 /****************************************************************************
49  * HGLOBALStreamImpl definition.
50  *
51  * This class implements the IStream interface and represents a stream
52  * supported by an HGLOBAL pointer.
53  */
54 struct HGLOBALStreamImpl
55 {
56   const IStreamVtbl *lpVtbl;   /* Needs to be the first item in the struct
57                           * since we want to cast this in an IStream pointer */
58
59   /*
60    * Reference count
61    */
62   LONG               ref;
63
64   /*
65    * Support for the stream
66    */
67   HGLOBAL supportHandle;
68
69   /*
70    * This flag is TRUE if the HGLOBAL is destroyed when the stream
71    * is finally released.
72    */
73   BOOL    deleteOnRelease;
74
75   /*
76    * Helper variable that contains the size of the stream
77    */
78   ULARGE_INTEGER     streamSize;
79
80   /*
81    * This is the current position of the cursor in the stream
82    */
83   ULARGE_INTEGER     currentPosition;
84 };
85
86 typedef struct HGLOBALStreamImpl HGLOBALStreamImpl;
87
88 /***
89  * This is the destructor of the HGLOBALStreamImpl class.
90  *
91  * This method will clean-up all the resources used-up by the given HGLOBALStreamImpl
92  * class. The pointer passed-in to this function will be freed and will not
93  * be valid anymore.
94  */
95 static void HGLOBALStreamImpl_Destroy(HGLOBALStreamImpl* This)
96 {
97   TRACE("(%p)\n", This);
98
99   /*
100    * Release the HGlobal if the constructor asked for that.
101    */
102   if (This->deleteOnRelease)
103   {
104     GlobalFree(This->supportHandle);
105     This->supportHandle=0;
106   }
107
108   /*
109    * Finally, free the memory used-up by the class.
110    */
111   HeapFree(GetProcessHeap(), 0, This);
112 }
113
114 /***
115  * This implements the IUnknown method AddRef for this
116  * class
117  */
118 static ULONG WINAPI HGLOBALStreamImpl_AddRef(
119                 IStream* iface)
120 {
121   HGLOBALStreamImpl* const This=(HGLOBALStreamImpl*)iface;
122   return InterlockedIncrement(&This->ref);
123 }
124
125 /***
126  * This implements the IUnknown method QueryInterface for this
127  * class
128  */
129 static HRESULT WINAPI HGLOBALStreamImpl_QueryInterface(
130                   IStream*     iface,
131                   REFIID         riid,        /* [in] */
132                   void**         ppvObject)   /* [iid_is][out] */
133 {
134   HGLOBALStreamImpl* const This=(HGLOBALStreamImpl*)iface;
135
136   /*
137    * Perform a sanity check on the parameters.
138    */
139   if (ppvObject==0)
140     return E_INVALIDARG;
141
142   /*
143    * Initialize the return parameter.
144    */
145   *ppvObject = 0;
146
147   /*
148    * Compare the riid with the interface IDs implemented by this object.
149    */
150   if (IsEqualIID(&IID_IUnknown, riid) ||
151       IsEqualIID(&IID_ISequentialStream, riid) ||
152       IsEqualIID(&IID_IStream, riid))
153   {
154     *ppvObject = This;
155   }
156
157   /*
158    * Check that we obtained an interface.
159    */
160   if ((*ppvObject)==0)
161     return E_NOINTERFACE;
162
163   /*
164    * Query Interface always increases the reference count by one when it is
165    * successful
166    */
167   HGLOBALStreamImpl_AddRef(iface);
168
169   return S_OK;
170 }
171
172 /***
173  * This implements the IUnknown method Release for this
174  * class
175  */
176 static ULONG WINAPI HGLOBALStreamImpl_Release(
177                 IStream* iface)
178 {
179   HGLOBALStreamImpl* const This=(HGLOBALStreamImpl*)iface;
180   ULONG newRef;
181
182   newRef = InterlockedDecrement(&This->ref);
183
184   /*
185    * If the reference count goes down to 0, perform suicide.
186    */
187   if (newRef==0)
188   {
189     HGLOBALStreamImpl_Destroy(This);
190   }
191
192   return newRef;
193 }
194
195 /***
196  * This method is part of the ISequentialStream interface.
197  *
198  * If reads a block of information from the stream at the current
199  * position. It then moves the current position at the end of the
200  * read block
201  *
202  * See the documentation of ISequentialStream for more info.
203  */
204 static HRESULT WINAPI HGLOBALStreamImpl_Read(
205                   IStream*     iface,
206                   void*          pv,        /* [length_is][size_is][out] */
207                   ULONG          cb,        /* [in] */
208                   ULONG*         pcbRead)   /* [out] */
209 {
210   HGLOBALStreamImpl* const This=(HGLOBALStreamImpl*)iface;
211
212   void* supportBuffer;
213   ULONG bytesReadBuffer;
214   ULONG bytesToReadFromBuffer;
215
216   TRACE("(%p, %p, %d, %p)\n", iface,
217         pv, cb, pcbRead);
218
219   /*
220    * If the caller is not interested in the nubmer of bytes read,
221    * we use another buffer to avoid "if" statements in the code.
222    */
223   if (pcbRead==0)
224     pcbRead = &bytesReadBuffer;
225
226   /*
227    * Using the known size of the stream, calculate the number of bytes
228    * to read from the block chain
229    */
230   bytesToReadFromBuffer = min( This->streamSize.u.LowPart - This->currentPosition.u.LowPart, cb);
231
232   /*
233    * Lock the buffer in position and copy the data.
234    */
235   supportBuffer = GlobalLock(This->supportHandle);
236   if (!supportBuffer)
237   {
238       WARN("read from invalid hglobal %p\n", This->supportHandle);
239       *pcbRead = 0;
240       return S_OK;
241   }
242
243   memcpy(pv, (char *) supportBuffer+This->currentPosition.u.LowPart, bytesToReadFromBuffer);
244
245   /*
246    * Move the current position to the new position
247    */
248   This->currentPosition.u.LowPart+=bytesToReadFromBuffer;
249
250   /*
251    * Return the number of bytes read.
252    */
253   *pcbRead = bytesToReadFromBuffer;
254
255   /*
256    * Cleanup
257    */
258   GlobalUnlock(This->supportHandle);
259
260   /*
261    * Always returns S_OK even if the end of the stream is reached before the
262    * buffer is filled
263    */
264
265   return S_OK;
266 }
267
268 /***
269  * This method is part of the ISequentialStream interface.
270  *
271  * It writes a block of information to the stream at the current
272  * position. It then moves the current position at the end of the
273  * written block. If the stream is too small to fit the block,
274  * the stream is grown to fit.
275  *
276  * See the documentation of ISequentialStream for more info.
277  */
278 static HRESULT WINAPI HGLOBALStreamImpl_Write(
279                   IStream*     iface,
280                   const void*    pv,          /* [size_is][in] */
281                   ULONG          cb,          /* [in] */
282                   ULONG*         pcbWritten)  /* [out] */
283 {
284   HGLOBALStreamImpl* const This=(HGLOBALStreamImpl*)iface;
285
286   void*          supportBuffer;
287   ULARGE_INTEGER newSize;
288   ULONG          bytesWritten = 0;
289
290   TRACE("(%p, %p, %d, %p)\n", iface, pv, cb, pcbWritten);
291
292   /*
293    * If the caller is not interested in the number of bytes written,
294    * we use another buffer to avoid "if" statements in the code.
295    */
296   if (pcbWritten == 0)
297     pcbWritten = &bytesWritten;
298
299   if (cb == 0)
300     goto out;
301
302   *pcbWritten = 0;
303
304   newSize.u.HighPart = 0;
305   newSize.u.LowPart = This->currentPosition.u.LowPart + cb;
306
307   /*
308    * Verify if we need to grow the stream
309    */
310   if (newSize.u.LowPart > This->streamSize.u.LowPart)
311   {
312     /* grow stream */
313     HRESULT hr = IStream_SetSize(iface, newSize);
314     if (FAILED(hr))
315     {
316       ERR("IStream_SetSize failed with error 0x%08x\n", hr);
317       return hr;
318     }
319   }
320
321   /*
322    * Lock the buffer in position and copy the data.
323    */
324   supportBuffer = GlobalLock(This->supportHandle);
325   if (!supportBuffer)
326   {
327       WARN("write to invalid hglobal %p\n", This->supportHandle);
328       return S_OK;
329   }
330
331   memcpy((char *) supportBuffer+This->currentPosition.u.LowPart, pv, cb);
332
333   /*
334    * Move the current position to the new position
335    */
336   This->currentPosition.u.LowPart+=cb;
337
338   /*
339    * Cleanup
340    */
341   GlobalUnlock(This->supportHandle);
342
343 out:
344   /*
345    * Return the number of bytes read.
346    */
347   *pcbWritten = cb;
348
349   return S_OK;
350 }
351
352 /***
353  * This method is part of the IStream interface.
354  *
355  * It will move the current stream pointer according to the parameters
356  * given.
357  *
358  * See the documentation of IStream for more info.
359  */
360 static HRESULT WINAPI HGLOBALStreamImpl_Seek(
361                   IStream*      iface,
362                   LARGE_INTEGER   dlibMove,         /* [in] */
363                   DWORD           dwOrigin,         /* [in] */
364                   ULARGE_INTEGER* plibNewPosition) /* [out] */
365 {
366   HGLOBALStreamImpl* const This=(HGLOBALStreamImpl*)iface;
367
368   ULARGE_INTEGER newPosition = This->currentPosition;
369   HRESULT hr = S_OK;
370
371   TRACE("(%p, %x%08x, %d, %p)\n", iface, dlibMove.u.HighPart,
372         dlibMove.u.LowPart, dwOrigin, plibNewPosition);
373
374   /*
375    * The file pointer is moved depending on the given "function"
376    * parameter.
377    */
378   switch (dwOrigin)
379   {
380     case STREAM_SEEK_SET:
381       newPosition.u.HighPart = 0;
382       newPosition.u.LowPart = 0;
383       break;
384     case STREAM_SEEK_CUR:
385       break;
386     case STREAM_SEEK_END:
387       newPosition = This->streamSize;
388       break;
389     default:
390       hr = STG_E_SEEKERROR;
391       goto end;
392   }
393
394   /*
395    * Move the actual file pointer
396    * If the file pointer ends-up after the end of the stream, the next Write operation will
397    * make the file larger. This is how it is documented.
398    */
399   newPosition.u.HighPart = 0;
400   newPosition.u.LowPart += dlibMove.QuadPart;
401
402   if (dlibMove.u.LowPart >= 0x80000000 &&
403       newPosition.u.LowPart >= dlibMove.u.LowPart)
404   {
405     /* We tried to seek backwards and went past the start. */
406     hr = STG_E_SEEKERROR;
407     goto end;
408   }
409
410   This->currentPosition = newPosition;
411
412 end:
413   if (plibNewPosition) *plibNewPosition = This->currentPosition;
414
415   return hr;
416 }
417
418 /***
419  * This method is part of the IStream interface.
420  *
421  * It will change the size of a stream.
422  *
423  * TODO: Switch from small blocks to big blocks and vice versa.
424  *
425  * See the documentation of IStream for more info.
426  */
427 static HRESULT WINAPI HGLOBALStreamImpl_SetSize(
428                                      IStream*      iface,
429                                      ULARGE_INTEGER  libNewSize)   /* [in] */
430 {
431   HGLOBALStreamImpl* const This=(HGLOBALStreamImpl*)iface;
432   HGLOBAL supportHandle;
433
434   TRACE("(%p, %d)\n", iface, libNewSize.u.LowPart);
435
436   /*
437    * HighPart is ignored as shown in tests
438    */
439
440   if (This->streamSize.u.LowPart == libNewSize.u.LowPart)
441     return S_OK;
442
443   /*
444    * Re allocate the HGlobal to fit the new size of the stream.
445    */
446   supportHandle = GlobalReAlloc(This->supportHandle, libNewSize.u.LowPart, 0);
447
448   if (supportHandle == 0)
449     return E_OUTOFMEMORY;
450
451   This->supportHandle = supportHandle;
452   This->streamSize.u.LowPart = libNewSize.u.LowPart;
453
454   return S_OK;
455 }
456
457 /***
458  * This method is part of the IStream interface.
459  *
460  * It will copy the 'cb' Bytes to 'pstm' IStream.
461  *
462  * See the documentation of IStream for more info.
463  */
464 static HRESULT WINAPI HGLOBALStreamImpl_CopyTo(
465                                     IStream*      iface,
466                                     IStream*      pstm,         /* [unique][in] */
467                                     ULARGE_INTEGER  cb,           /* [in] */
468                                     ULARGE_INTEGER* pcbRead,      /* [out] */
469                                     ULARGE_INTEGER* pcbWritten)   /* [out] */
470 {
471   HRESULT        hr = S_OK;
472   BYTE           tmpBuffer[128];
473   ULONG          bytesRead, bytesWritten, copySize;
474   ULARGE_INTEGER totalBytesRead;
475   ULARGE_INTEGER totalBytesWritten;
476
477   TRACE("(%p, %p, %d, %p, %p)\n", iface, pstm,
478         cb.u.LowPart, pcbRead, pcbWritten);
479
480   if ( pstm == 0 )
481     return STG_E_INVALIDPOINTER;
482
483   totalBytesRead.QuadPart = 0;
484   totalBytesWritten.QuadPart = 0;
485
486   while ( cb.QuadPart > 0 )
487   {
488     if ( cb.QuadPart >= sizeof(tmpBuffer) )
489       copySize = sizeof(tmpBuffer);
490     else
491       copySize = cb.u.LowPart;
492
493     hr = IStream_Read(iface, tmpBuffer, copySize, &bytesRead);
494     if (FAILED(hr))
495         break;
496
497     totalBytesRead.QuadPart += bytesRead;
498
499     if (bytesRead)
500     {
501         hr = IStream_Write(pstm, tmpBuffer, bytesRead, &bytesWritten);
502         if (FAILED(hr))
503             break;
504
505         totalBytesWritten.QuadPart += bytesWritten;
506     }
507
508     if (bytesRead!=copySize)
509       cb.QuadPart = 0;
510     else
511       cb.QuadPart -= bytesRead;
512   }
513
514   if (pcbRead) pcbRead->QuadPart = totalBytesRead.QuadPart;
515   if (pcbWritten) pcbWritten->QuadPart = totalBytesWritten.QuadPart;
516
517   return hr;
518 }
519
520 /***
521  * This method is part of the IStream interface.
522  *
523  * For streams supported by HGLOBALS, this function does nothing.
524  * This is what the documentation tells us.
525  *
526  * See the documentation of IStream for more info.
527  */
528 static HRESULT WINAPI HGLOBALStreamImpl_Commit(
529                   IStream*      iface,
530                   DWORD         grfCommitFlags)  /* [in] */
531 {
532   return S_OK;
533 }
534
535 /***
536  * This method is part of the IStream interface.
537  *
538  * For streams supported by HGLOBALS, this function does nothing.
539  * This is what the documentation tells us.
540  *
541  * See the documentation of IStream for more info.
542  */
543 static HRESULT WINAPI HGLOBALStreamImpl_Revert(
544                   IStream* iface)
545 {
546   return S_OK;
547 }
548
549 /***
550  * This method is part of the IStream interface.
551  *
552  * For streams supported by HGLOBALS, this function does nothing.
553  * This is what the documentation tells us.
554  *
555  * See the documentation of IStream for more info.
556  */
557 static HRESULT WINAPI HGLOBALStreamImpl_LockRegion(
558                   IStream*       iface,
559                   ULARGE_INTEGER libOffset,   /* [in] */
560                   ULARGE_INTEGER cb,          /* [in] */
561                   DWORD          dwLockType)  /* [in] */
562 {
563   return STG_E_INVALIDFUNCTION;
564 }
565
566 /*
567  * This method is part of the IStream interface.
568  *
569  * For streams supported by HGLOBALS, this function does nothing.
570  * This is what the documentation tells us.
571  *
572  * See the documentation of IStream for more info.
573  */
574 static HRESULT WINAPI HGLOBALStreamImpl_UnlockRegion(
575                   IStream*       iface,
576                   ULARGE_INTEGER libOffset,   /* [in] */
577                   ULARGE_INTEGER cb,          /* [in] */
578                   DWORD          dwLockType)  /* [in] */
579 {
580   return S_OK;
581 }
582
583 /***
584  * This method is part of the IStream interface.
585  *
586  * This method returns information about the current
587  * stream.
588  *
589  * See the documentation of IStream for more info.
590  */
591 static HRESULT WINAPI HGLOBALStreamImpl_Stat(
592                   IStream*     iface,
593                   STATSTG*     pstatstg,     /* [out] */
594                   DWORD        grfStatFlag)  /* [in] */
595 {
596   HGLOBALStreamImpl* const This=(HGLOBALStreamImpl*)iface;
597
598   memset(pstatstg, 0, sizeof(STATSTG));
599
600   pstatstg->pwcsName = NULL;
601   pstatstg->type     = STGTY_STREAM;
602   pstatstg->cbSize   = This->streamSize;
603
604   return S_OK;
605 }
606
607 static HRESULT WINAPI HGLOBALStreamImpl_Clone(
608                   IStream*     iface,
609                   IStream**    ppstm) /* [out] */
610 {
611   ULARGE_INTEGER dummy;
612   LARGE_INTEGER offset;
613   HRESULT hr;
614   HGLOBALStreamImpl* const This=(HGLOBALStreamImpl*)iface;
615   TRACE(" Cloning %p (deleteOnRelease=%d seek position=%ld)\n",iface,This->deleteOnRelease,(long)This->currentPosition.QuadPart);
616   hr=CreateStreamOnHGlobal(This->supportHandle, FALSE, ppstm);
617   if(FAILED(hr))
618     return hr;
619   offset.QuadPart=(LONGLONG)This->currentPosition.QuadPart;
620   HGLOBALStreamImpl_Seek(*ppstm,offset,STREAM_SEEK_SET,&dummy);
621   return S_OK;
622 }
623
624 /*
625  * Virtual function table for the HGLOBALStreamImpl class.
626  */
627 static const IStreamVtbl HGLOBALStreamImpl_Vtbl =
628 {
629     HGLOBALStreamImpl_QueryInterface,
630     HGLOBALStreamImpl_AddRef,
631     HGLOBALStreamImpl_Release,
632     HGLOBALStreamImpl_Read,
633     HGLOBALStreamImpl_Write,
634     HGLOBALStreamImpl_Seek,
635     HGLOBALStreamImpl_SetSize,
636     HGLOBALStreamImpl_CopyTo,
637     HGLOBALStreamImpl_Commit,
638     HGLOBALStreamImpl_Revert,
639     HGLOBALStreamImpl_LockRegion,
640     HGLOBALStreamImpl_UnlockRegion,
641     HGLOBALStreamImpl_Stat,
642     HGLOBALStreamImpl_Clone
643 };
644
645 /******************************************************************************
646 ** HGLOBALStreamImpl implementation
647 */
648
649 /***
650  * This is the constructor for the HGLOBALStreamImpl class.
651  *
652  * Params:
653  *    hGlobal          - Handle that will support the stream. can be NULL.
654  *    fDeleteOnRelease - Flag set to TRUE if the HGLOBAL will be released
655  *                       when the IStream object is destroyed.
656  */
657 static HGLOBALStreamImpl* HGLOBALStreamImpl_Construct(
658                 HGLOBAL  hGlobal,
659                 BOOL     fDeleteOnRelease)
660 {
661   HGLOBALStreamImpl* newStream;
662
663   newStream = HeapAlloc(GetProcessHeap(), 0, sizeof(HGLOBALStreamImpl));
664
665   if (newStream!=0)
666   {
667     /*
668      * Set-up the virtual function table and reference count.
669      */
670     newStream->lpVtbl = &HGLOBALStreamImpl_Vtbl;
671     newStream->ref    = 0;
672
673     /*
674      * Initialize the support.
675      */
676     newStream->supportHandle = hGlobal;
677     newStream->deleteOnRelease = fDeleteOnRelease;
678
679     /*
680      * This method will allocate a handle if one is not supplied.
681      */
682     if (!newStream->supportHandle)
683     {
684       newStream->supportHandle = GlobalAlloc(GMEM_MOVEABLE | GMEM_NODISCARD |
685                                              GMEM_SHARE, 0);
686     }
687
688     /*
689      * Start the stream at the beginning.
690      */
691     newStream->currentPosition.u.HighPart = 0;
692     newStream->currentPosition.u.LowPart = 0;
693
694     /*
695      * Initialize the size of the stream to the size of the handle.
696      */
697     newStream->streamSize.u.HighPart = 0;
698     newStream->streamSize.u.LowPart  = GlobalSize(newStream->supportHandle);
699   }
700
701   return newStream;
702 }
703
704
705 /***********************************************************************
706  *           CreateStreamOnHGlobal     [OLE32.@]
707  */
708 HRESULT WINAPI CreateStreamOnHGlobal(
709                 HGLOBAL   hGlobal,
710                 BOOL      fDeleteOnRelease,
711                 LPSTREAM* ppstm)
712 {
713   HGLOBALStreamImpl* newStream;
714
715   if (!ppstm)
716     return E_INVALIDARG;
717
718   newStream = HGLOBALStreamImpl_Construct(hGlobal,
719                                           fDeleteOnRelease);
720
721   if (newStream!=NULL)
722   {
723     return IUnknown_QueryInterface((IUnknown*)newStream,
724                                    &IID_IStream,
725                                    (void**)ppstm);
726   }
727
728   return E_OUTOFMEMORY;
729 }
730
731 /***********************************************************************
732  *           GetHGlobalFromStream     [OLE32.@]
733  */
734 HRESULT WINAPI GetHGlobalFromStream(IStream* pstm, HGLOBAL* phglobal)
735 {
736   HGLOBALStreamImpl* pStream;
737
738   if (pstm == NULL)
739     return E_INVALIDARG;
740
741   pStream = (HGLOBALStreamImpl*) pstm;
742
743   /*
744    * Verify that the stream object was created with CreateStreamOnHGlobal.
745    */
746   if (pStream->lpVtbl == &HGLOBALStreamImpl_Vtbl)
747     *phglobal = pStream->supportHandle;
748   else
749   {
750     *phglobal = 0;
751     return E_INVALIDARG;
752   }
753
754   return S_OK;
755 }