1 /*************************************************************************
3 * SafeArray Implementation
5 * This file contains the implementation of the SafeArray interface.
7 * Copyright 1999 Sylvain St-Germain
16 #include "wine/obj_base.h"
17 #include "debugtools.h"
19 DEFAULT_DEBUG_CHANNEL(ole
);
21 /* Localy used methods */
23 endOfDim(LONG
*coor
, SAFEARRAYBOUND
*mat
, LONG dim
, LONG realDim
);
26 calcDisplacement(LONG
*coor
, SAFEARRAYBOUND
*mat
, LONG dim
);
29 isPointer(USHORT feature
);
32 getFeatures(VARTYPE vt
);
35 validCoordinate(LONG
*coor
, SAFEARRAY
*psa
);
38 resizeSafeArray(SAFEARRAY
*psa
, LONG lDelta
);
41 validArg(SAFEARRAY
*psa
);
44 getArraySize(SAFEARRAY
*psa
);
47 duplicateData(SAFEARRAY
*psa
, SAFEARRAY
**ppsaOut
);
49 /* Association between VARTYPE and their size.
50 A size of zero is defined for the unsupported types. */
52 #define VARTYPE_NOT_SUPPORTED 0
53 static const ULONG VARTYPE_SIZE
[] =
55 /* this is taken from wtypes.h. Only [S]es are supported by the SafeArray */
56 VARTYPE_NOT_SUPPORTED
, /* VT_EMPTY [V] [P] nothing */
57 VARTYPE_NOT_SUPPORTED
, /* VT_NULL [V] [P] SQL style Nul */
58 2, /* VT_I2 [V][T][P][S] 2 byte signed int */
59 4, /* VT_I4 [V][T][P][S] 4 byte signed int */
60 4, /* VT_R4 [V][T][P][S] 4 byte real */
61 8, /* VT_R8 [V][T][P][S] 8 byte real */
62 8, /* VT_CY [V][T][P][S] currency */
63 8, /* VT_DATE [V][T][P][S] date */
64 4, /* VT_BSTR [V][T][P][S] OLE Automation string*/
65 4, /* VT_DISPATCH [V][T][P][S] IDispatch * */
66 4, /* VT_ERROR [V][T] [S] SCODE */
67 4, /* VT_BOOL [V][T][P][S] True=-1, False=0*/
68 24, /* VT_VARIANT [V][T][P][S] VARIANT * */
69 4, /* VT_UNKNOWN [V][T] [S] IUnknown * */
70 16, /* VT_DECIMAL [V][T] [S] 16 byte fixed point */
71 VARTYPE_NOT_SUPPORTED
, /* no VARTYPE here..... */
72 VARTYPE_NOT_SUPPORTED
, /* VT_I1 [T] signed char */
73 1, /* VT_UI1 [V][T][P][S] unsigned char */
74 VARTYPE_NOT_SUPPORTED
, /* VT_UI2 [T][P] unsigned short */
75 VARTYPE_NOT_SUPPORTED
, /* VT_UI4 [T][P] unsigned short */
76 VARTYPE_NOT_SUPPORTED
, /* VT_I8 [T][P] signed 64-bit int */
77 VARTYPE_NOT_SUPPORTED
, /* VT_UI8 [T][P] unsigned 64-bit int */
78 VARTYPE_NOT_SUPPORTED
, /* VT_INT [T] signed machine int */
79 VARTYPE_NOT_SUPPORTED
, /* VT_UINT [T] unsigned machine int */
80 VARTYPE_NOT_SUPPORTED
, /* VT_VOID [T] C style void */
81 VARTYPE_NOT_SUPPORTED
, /* VT_HRESULT [T] Standard return type */
82 VARTYPE_NOT_SUPPORTED
, /* VT_PTR [T] pointer type */
83 VARTYPE_NOT_SUPPORTED
, /* VT_SAFEARRAY [T] (use VT_ARRAY in VARIANT)*/
84 VARTYPE_NOT_SUPPORTED
, /* VT_CARRAY [T] C style array */
85 VARTYPE_NOT_SUPPORTED
, /* VT_USERDEFINED [T] user defined type */
86 VARTYPE_NOT_SUPPORTED
, /* VT_LPSTR [T][P] null terminated string */
87 VARTYPE_NOT_SUPPORTED
, /* VT_LPWSTR [T][P] wide null term string */
88 VARTYPE_NOT_SUPPORTED
, /* VT_FILETIME [P] FILETIME */
89 VARTYPE_NOT_SUPPORTED
, /* VT_BLOB [P] Length prefixed bytes */
90 VARTYPE_NOT_SUPPORTED
, /* VT_STREAM [P] Name of stream follows */
91 VARTYPE_NOT_SUPPORTED
, /* VT_STORAGE [P] Name of storage follows */
92 VARTYPE_NOT_SUPPORTED
, /* VT_STREAMED_OBJECT[P] Stream contains an object*/
93 VARTYPE_NOT_SUPPORTED
, /* VT_STORED_OBJECT [P] Storage contains object*/
94 VARTYPE_NOT_SUPPORTED
, /* VT_BLOB_OBJECT [P] Blob contains an object*/
95 VARTYPE_NOT_SUPPORTED
, /* VT_CF [P] Clipboard format */
96 VARTYPE_NOT_SUPPORTED
, /* VT_CLSID [P] A Class ID */
97 VARTYPE_NOT_SUPPORTED
, /* VT_VECTOR [P] simple counted array */
98 VARTYPE_NOT_SUPPORTED
, /* VT_ARRAY [V] SAFEARRAY* */
99 VARTYPE_NOT_SUPPORTED
/* VT_BYREF [V] void* for local use */
102 static const int LAST_VARTYPE
= sizeof(VARTYPE_SIZE
)/sizeof(ULONG
);
105 /*************************************************************************
106 * SafeArrayAllocDescriptor
107 * Allocate the appropriate amount of memory for the SafeArray descriptor
109 HRESULT WINAPI
SafeArrayAllocDescriptor(
116 /* SAFEARRAY + SAFEARRAYBOUND * (cDims -1) ( -1 because there is already one
117 ( in SAFEARRAY struct */
118 allocSize
= sizeof(**ppsaOut
) + (sizeof(*sab
) * (cDims
-1));
120 /* Allocate memory for SAFEARRAY struc */
121 if(( (*ppsaOut
)=HeapAlloc(
122 GetProcessHeap(), HEAP_ZERO_MEMORY
, allocSize
)) == NULL
){
123 return(E_UNEXPECTED
);
125 TRACE("SafeArray: %lu bytes allocated for descriptor.\n", allocSize
);
130 /*************************************************************************
132 * Allocate the appropriate amount of data for the SafeArray data
134 HRESULT WINAPI
SafeArrayAllocData(
137 ULONG ulWholeArraySize
; /* to store the size of the whole thing */
142 ulWholeArraySize
= getArraySize(psa
);
144 /* Allocate memory for the data itself */
145 if((psa
->pvData
= HeapAlloc( GetProcessHeap(), HEAP_ZERO_MEMORY
,
146 psa
->cbElements
*ulWholeArraySize
)) == NULL
)
147 return(E_UNEXPECTED
);
149 TRACE("SafeArray: %lu bytes allocated for data at %p (%lu objects).\n",
150 psa
->cbElements
*ulWholeArraySize
, psa
->pvData
, ulWholeArraySize
);
155 /*************************************************************************
157 * Create a SafeArray object by encapsulating AllocDescriptor and AllocData
159 SAFEARRAY
* WINAPI
SafeArrayCreate(
162 SAFEARRAYBOUND
*rgsabound
)
168 /* Validate supported VARTYPE */
169 if ( (vt
>= LAST_VARTYPE
) ||
170 ( VARTYPE_SIZE
[vt
] == VARTYPE_NOT_SUPPORTED
) )
173 /* Allocate memory for the array descriptor */
174 if( FAILED( hRes
= SafeArrayAllocDescriptor(cDims
, &psa
)))
177 /* setup data members... */
179 psa
->fFeatures
= getFeatures(vt
);
182 psa
->cbElements
= VARTYPE_SIZE
[vt
];
184 /* Invert the bounds ... */
185 for(cDim
=0; cDim
< psa
->cDims
; cDim
++) {
186 psa
->rgsabound
[cDim
].cElements
= rgsabound
[psa
->cDims
-cDim
-1].cElements
;
187 psa
->rgsabound
[cDim
].lLbound
= rgsabound
[psa
->cDims
-cDim
-1].lLbound
;
190 /* allocate memory for the data... */
191 if( FAILED( hRes
= SafeArrayAllocData(psa
))) {
192 SafeArrayDestroyDescriptor(psa
);
193 ERR("() : Failed to allocate the Safe Array data\n");
200 /*************************************************************************
201 * SafeArrayDestroyDescriptor
202 * Frees the memory associated with the descriptor.
204 HRESULT WINAPI
SafeArrayDestroyDescriptor(
207 /* Check for lockness before to free... */
209 return DISP_E_ARRAYISLOCKED
;
211 /* The array is unlocked, then, deallocate memory */
212 if(HeapFree( GetProcessHeap(), 0, psa
) == FALSE
)
219 /*************************************************************************
221 * Increment the lock counter
223 * Doc says (MSDN Library ) that psa->pvData should be made available (!= NULL)
224 * only when psa->cLocks is > 0... I don't get it since pvData is allocated
225 * before the array is locked, therefore
227 HRESULT WINAPI
SafeArrayLock(
238 /*************************************************************************
240 * Decrement the lock counter
242 HRESULT WINAPI
SafeArrayUnlock(
255 /*************************************************************************
256 * SafeArrayPutElement
257 * Set the data at the given coordinate
259 HRESULT WINAPI
SafeArrayPutElement(
264 ULONG stepCountInSAData
= 0; /* Number of array item to skip to get to
265 the desired one... */
266 PVOID elementStorageAddress
= NULL
; /* Adress to store the data */
267 BSTR pbstrReAllocStr
= NULL
; /* BSTR reallocated */
269 /* Validate the index given */
270 if(! validCoordinate(rgIndices
, psa
))
271 return DISP_E_BADINDEX
;
275 if( SafeArrayLock(psa
) == S_OK
) {
277 /* Figure out the number of items to skip */
278 stepCountInSAData
= calcDisplacement(rgIndices
, psa
->rgsabound
, psa
->cDims
);
280 /* Figure out the number of byte to skip ... */
281 elementStorageAddress
= (char *) psa
->pvData
+(stepCountInSAData
*psa
->cbElements
);
283 if(isPointer(psa
->fFeatures
)) { /* increment ref count for this pointer */
285 *((VOID
**)elementStorageAddress
) = *(VOID
**)pv
;
286 IUnknown_AddRef( *(IUnknown
**)pv
);
290 if(psa
->fFeatures
== FADF_BSTR
) { /* Create a new object */
292 if((pbstrReAllocStr
= SysAllocString( (OLECHAR
*)pv
)) == NULL
) {
293 SafeArrayUnlock(psa
);
294 return E_OUTOFMEMORY
;
296 *((BSTR
*)elementStorageAddress
) = pbstrReAllocStr
;
298 } else /* dupplicate the memory */
299 memcpy(elementStorageAddress
, pv
, SafeArrayGetElemsize(psa
) );
303 ERR("SafeArray: Cannot lock array....\n");
304 return E_UNEXPECTED
; /* UNDOC error condition */
307 TRACE("SafeArray: item put at adress %p.\n",elementStorageAddress
);
308 return SafeArrayUnlock(psa
);
312 /*************************************************************************
313 * SafeArrayGetElement
314 * Return the data element corresponding the the given coordinate
316 HRESULT WINAPI
SafeArrayGetElement(
321 ULONG stepCountInSAData
= 0; /* Number of array item to skip to get to
322 the desired one... */
323 PVOID elementStorageAddress
= NULL
; /* Adress to store the data */
324 BSTR pbstrReturnedStr
= NULL
; /* BSTR reallocated */
329 if(! validCoordinate(rgIndices
, psa
)) /* Validate the index given */
330 return(DISP_E_BADINDEX
);
332 if( SafeArrayLock(psa
) == S_OK
) {
334 /* Figure out the number of items to skip */
335 stepCountInSAData
= calcDisplacement(rgIndices
, psa
->rgsabound
, psa
->cDims
);
337 /* Figure out the number of byte to skip ... */
338 elementStorageAddress
= (char *) psa
->pvData
+(stepCountInSAData
*psa
->cbElements
);
340 if( psa
->fFeatures
== FADF_BSTR
) { /* reallocate the obj */
341 if( (pbstrReturnedStr
=
342 SysAllocString( *(OLECHAR
**)elementStorageAddress
)) == NULL
) {
343 SafeArrayUnlock(psa
);
344 return E_OUTOFMEMORY
;
346 *((BSTR
*)pv
) = pbstrReturnedStr
;
348 } else if( isPointer(psa
->fFeatures
) ) /* simply copy the pointer */
349 pv
= *((PVOID
*)elementStorageAddress
);
350 else /* copy the bytes */
351 memcpy(pv
, elementStorageAddress
, SafeArrayGetElemsize(psa
) );
354 ERR("SafeArray: Cannot lock array....\n");
355 return E_UNEXPECTED
; /* UNDOC error condition */
358 return( SafeArrayUnlock(psa
) );
361 /*************************************************************************
363 * return the UP bound for a given array dimension
365 HRESULT WINAPI
SafeArrayGetUBound(
373 if(nDim
> psa
->cDims
)
374 return DISP_E_BADINDEX
;
377 return DISP_E_BADINDEX
;
379 *plUbound
= psa
->rgsabound
[nDim
-1].lLbound
+
380 psa
->rgsabound
[nDim
-1].cElements
- 1;
385 /*************************************************************************
387 * Return the LO bound for a given array dimension
389 HRESULT WINAPI
SafeArrayGetLBound(
397 if(nDim
> psa
->cDims
)
398 return DISP_E_BADINDEX
;
401 return DISP_E_BADINDEX
;
403 *plLbound
= psa
->rgsabound
[nDim
-1].lLbound
;
407 /*************************************************************************
409 * returns the number of dimension in the array
411 UINT WINAPI
SafeArrayGetDim(
415 * A quick test in Windows shows that the behavior here for an invalid
416 * pointer is to return 0.
424 /*************************************************************************
425 * SafeArrayGetElemsize
426 * Return the size of the element in the array
428 UINT WINAPI
SafeArrayGetElemsize(
432 * A quick test in Windows shows that the behavior here for an invalid
433 * pointer is to return 0.
438 return psa
->cbElements
;
441 /*************************************************************************
442 * SafeArrayAccessData
443 * increment the access count and return the data
445 HRESULT WINAPI
SafeArrayAccessData(
454 hRes
= SafeArrayLock(psa
);
458 (*ppvData
) = psa
->pvData
;
469 /*************************************************************************
470 * SafeArrayUnaccessData
471 * Decrement the access count
473 HRESULT WINAPI
SafeArrayUnaccessData(
479 return(SafeArrayUnlock(psa
));
482 /************************************************************************
483 * SafeArrayPtrOfIndex
484 * Return a pointer to the element at rgIndices
486 HRESULT WINAPI
SafeArrayPtrOfIndex(
491 ULONG stepCountInSAData
= 0; /* Number of array item to skip to get to
492 the desired one... */
497 if(! validCoordinate(rgIndices
, psa
))
498 return DISP_E_BADINDEX
;
500 /* Figure out the number of items to skip */
501 stepCountInSAData
= calcDisplacement(rgIndices
, psa
->rgsabound
, psa
->cDims
);
503 *ppvData
= (char *) psa
->pvData
+(stepCountInSAData
*psa
->cbElements
);
508 /************************************************************************
509 * SafeArrayDestroyData
510 * Frees the memory data bloc
512 HRESULT WINAPI
SafeArrayDestroyData(
516 ULONG ulWholeArraySize
; /* count spot in array */
517 ULONG ulDataIter
; /* to iterate the data space */
525 return DISP_E_ARRAYISLOCKED
;
527 ulWholeArraySize
= getArraySize(psa
);
529 if(isPointer(psa
->fFeatures
)) { /* release the pointers */
531 for(ulDataIter
=0; ulDataIter
< ulWholeArraySize
; ulDataIter
++) {
532 punk
= *(IUnknown
**)((char *) psa
->pvData
+(ulDataIter
*(psa
->cbElements
)));
535 IUnknown_Release(punk
);
538 } else if(psa
->fFeatures
& FADF_BSTR
) { /* deallocate the obj */
540 for(ulDataIter
=0; ulDataIter
< ulWholeArraySize
; ulDataIter
++) {
541 bstr
= *(BSTR
*)((char *) psa
->pvData
+(ulDataIter
*(psa
->cbElements
)));
544 SysFreeString( bstr
);
548 /* check if this array is a Vector, in which case do not free the data
549 block since it has been allocated by AllocDescriptor and therefore
550 deserve to be freed by DestroyDescriptor */
551 if(!(psa
->fFeatures
& FADF_CREATEVECTOR
)) { /* Set when we do CreateVector */
553 /* free the whole chunk */
554 if((hRes
= HeapFree( GetProcessHeap(), 0, psa
->pvData
)) == 0) /*falied*/
555 return E_UNEXPECTED
; /* UNDOC error condition */
563 /************************************************************************
565 * Copy the psaSource's data block into psaTarget if dimension and size
568 HRESULT WINAPI
SafeArrayCopyData(
569 SAFEARRAY
*psaSource
,
570 SAFEARRAY
**psaTarget
)
572 USHORT cDimCount
; /* looper */
573 LONG lDelta
; /* looper */
575 ULONG ulWholeArraySize
; /* Number of item in SA */
578 if(! (validArg(psaSource
) && validArg(*psaTarget
)) )
581 if(SafeArrayGetDim(psaSource
) != SafeArrayGetDim(*psaTarget
))
584 ulWholeArraySize
= getArraySize(psaSource
);
586 /* The two arrays boundaries must be of same lenght */
587 for(cDimCount
=0;cDimCount
< psaSource
->cDims
; cDimCount
++)
588 if( psaSource
->rgsabound
[cDimCount
].cElements
!=
589 (*psaTarget
)->rgsabound
[cDimCount
].cElements
)
592 if( isPointer((*psaTarget
)->fFeatures
) ) { /* the target contains ptr
593 that must be released */
594 for(lDelta
=0;lDelta
< ulWholeArraySize
; lDelta
++) {
596 ((char *) (*psaTarget
)->pvData
+ (lDelta
* (*psaTarget
)->cbElements
));
599 IUnknown_Release(punk
);
602 } else if( (*psaTarget
)->fFeatures
& FADF_BSTR
) { /* the target contain BSTR
603 that must be freed */
604 for(lDelta
=0;lDelta
< ulWholeArraySize
; lDelta
++) {
606 *(BSTR
*)((char *) (*psaTarget
)->pvData
+ (lDelta
* (*psaTarget
)->cbElements
));
609 SysFreeString( bstr
);
613 return duplicateData(psaSource
, psaTarget
);
616 /************************************************************************
618 * Deallocates all memory reserved for the SafeArray
620 HRESULT WINAPI
SafeArrayDestroy(
629 return DISP_E_ARRAYISLOCKED
;
631 if((hRes
= SafeArrayDestroyData( psa
)) == S_OK
)
632 if((hRes
= SafeArrayDestroyDescriptor( psa
)) == S_OK
)
635 return E_UNEXPECTED
; /* UNDOC error condition */
638 /************************************************************************
640 * Make a dupplicate of a SafeArray
642 HRESULT WINAPI
SafeArrayCopy(
648 ULONG ulWholeArraySize
; /* size of the thing */
653 if((hRes
=SafeArrayAllocDescriptor(psa
->cDims
, ppsaOut
)) == S_OK
){
655 /* Duplicate the SAFEARRAY struc */
656 memcpy(*ppsaOut
, psa
,
657 sizeof(*psa
)+(sizeof(*(psa
->rgsabound
))*(psa
->cDims
-1)));
659 (*ppsaOut
)->pvData
= NULL
; /* do not point to the same data area */
661 /* make sure the new safe array doesn't have the FADF_CREATEVECTOR flag,
662 because the data has not been allocated with the descriptor. */
663 (*ppsaOut
)->fFeatures
&= ~FADF_CREATEVECTOR
;
665 /* Get the allocated memory size for source and allocate it for target */
666 ulWholeArraySize
= getArraySize(psa
); /* Number of item in SA */
667 dAllocSize
= ulWholeArraySize
*psa
->cbElements
;
670 HeapAlloc(GetProcessHeap(), HEAP_ZERO_MEMORY
, dAllocSize
);
671 if( (*ppsaOut
)->pvData
!= NULL
) { /* HeapAlloc succeed */
673 if( (hRes
=duplicateData(psa
, ppsaOut
)) != S_OK
) { /* E_OUTOFMEMORY */
674 HeapFree(GetProcessHeap(), 0, (*ppsaOut
)->pvData
);
675 (*ppsaOut
)->pvData
= NULL
;
676 SafeArrayDestroyDescriptor(*ppsaOut
);
680 } else { /* failed to allocate or dupplicate... */
681 SafeArrayDestroyDescriptor(*ppsaOut
);
682 return E_UNEXPECTED
; /* UNDOC error condition */
684 } else { /* failed to allocate mem for descriptor */
685 return E_OUTOFMEMORY
; /* UNDOC error condiftion */
691 /************************************************************************
692 * SafeArrayCreateVector
693 * Creates a one dimension safearray where the data is next to the
694 * SAFEARRAY structure.
696 SAFEARRAY
* WINAPI
SafeArrayCreateVector(
703 /* Validate supported VARTYPE */
704 if ( (vt
>= LAST_VARTYPE
) ||
705 ( VARTYPE_SIZE
[vt
] == VARTYPE_NOT_SUPPORTED
) )
708 /* Allocate memory for the array descriptor and data contiguously */
709 if( FAILED( psa
= HeapAlloc( GetProcessHeap(),
711 (sizeof(*psa
) + (VARTYPE_SIZE
[vt
] * cElements
))))) {
715 /* setup data members... */
716 psa
->cDims
= 1; /* always and forever */
717 psa
->fFeatures
= getFeatures(vt
) | FADF_CREATEVECTOR
; /* undocumented flag used by Microsoft */
719 psa
->pvData
= (BYTE
*)psa
+ sizeof(*psa
);
720 psa
->cbElements
= VARTYPE_SIZE
[vt
];
722 psa
->rgsabound
[0].cElements
= cElements
;
723 psa
->rgsabound
[0].lLbound
= lLbound
;
728 /************************************************************************
730 * Changes the caracteristics of the last dimension of the SafeArray
732 HRESULT WINAPI
SafeArrayRedim(
734 SAFEARRAYBOUND
*psaboundNew
)
736 LONG lDelta
; /* hold difference in size */
737 USHORT cDims
=1; /* dims counter */
742 if( psa
->cLocks
> 0 )
743 return DISP_E_ARRAYISLOCKED
;
745 if( psa
->fFeatures
& FADF_FIXEDSIZE
)
748 if( SafeArrayLock(psa
)==E_UNEXPECTED
)
749 return E_UNEXPECTED
;/* UNDOC error condition */
751 /* find the delta in number of array spot to apply to the new array */
752 lDelta
= psaboundNew
->cElements
- psa
->rgsabound
[0].cElements
;
753 for(; cDims
< psa
->cDims
; cDims
++)
754 /* delta in number of spot implied by modifying the last dimension */
755 lDelta
*= psa
->rgsabound
[cDims
].cElements
;
757 if (lDelta
== 0) { ;/* same size, maybe a change of lLbound, just set it */
759 } else /* need to enlarge (lDelta +) reduce (lDelta -) */
760 if(! resizeSafeArray(psa
, lDelta
))
761 return E_UNEXPECTED
; /* UNDOC error condition */
763 /* the only modifyable dimension sits in [0] as the dimensions were reversed
764 at array creation time... */
765 psa
->rgsabound
[0].cElements
= psaboundNew
->cElements
;
766 psa
->rgsabound
[0].lLbound
= psaboundNew
->lLbound
;
768 return SafeArrayUnlock(psa
);
771 /************************************************************************
772 * NOT WINDOWS API - SafeArray* Utility functions
773 ************************************************************************/
775 /************************************************************************
776 * Used to validate the SAFEARRAY type of arg
778 static BOOL
validArg(
787 * Let's check for the null pointer just in case.
792 /* Check whether the size of the chunk makes sense... That's the only thing
793 I can think of now... */
795 psaSize
= HeapSize(GetProcessHeap(), 0, psa
);
797 /* uh, foreign heap. Better don't mess with it ! */
800 /* size of the descriptor when the SA is not created with CreateVector */
801 descSize
= sizeof(*psa
) + (sizeof(*sab
) * (psa
->cDims
-1));
803 /* size of the descriptor + data when created with CreateVector */
804 fullSize
= sizeof(*psa
) + (psa
->cbElements
* psa
->rgsabound
[0].cElements
);
806 return((psaSize
>= descSize
) || (psaSize
>= fullSize
));
809 /************************************************************************
810 * Used to reallocate memory
812 static BOOL
resizeSafeArray(
816 ULONG ulWholeArraySize
; /* use as multiplicator */
817 PVOID pvNewBlock
= NULL
;
821 ulWholeArraySize
= getArraySize(psa
);
823 if(lDelta
< 0) { /* array needs to be shorthen */
824 if( isPointer(psa
->fFeatures
)) /* ptr that need to be released */
825 for(;lDelta
< 0; lDelta
++) {
827 ((char *) psa
->pvData
+((ulWholeArraySize
+lDelta
)*psa
->cbElements
));
830 IUnknown_Release(punk
);
833 else if(psa
->fFeatures
& FADF_BSTR
) /* BSTR that need to be freed */
834 for(;lDelta
< 0; lDelta
++) {
836 ((char *) psa
->pvData
+((ulWholeArraySize
+lDelta
)*psa
->cbElements
));
839 SysFreeString( bstr
);
843 if (!(psa
->fFeatures
& FADF_CREATEVECTOR
))
845 /* Ok now, if we are enlarging the array, we *MUST* move the whole block
846 pointed to by pvData. If we are shorthening the array, this move is
847 optional but we do it anyway becuase the benefit is that we are
848 releasing to the system the unused memory */
850 if((pvNewBlock
= HeapReAlloc(GetProcessHeap(), 0, psa
->pvData
,
851 (ulWholeArraySize
+ lDelta
) * psa
->cbElements
)) == NULL
)
852 return FALSE
; /* TODO If we get here it means:
853 SHRINK situation : we've deleted the undesired
854 data and did not release the memory
855 GROWING situation: we've been unable to grow the array
860 /* Allocate a new block, because the previous data has been allocated with
861 the descriptor in SafeArrayCreateVector function. */
863 if((pvNewBlock
= HeapAlloc(GetProcessHeap(), 0,
864 ulWholeArraySize
* psa
->cbElements
)) == NULL
)
867 psa
->fFeatures
&= ~FADF_CREATEVECTOR
;
869 /* reassign to the new block of data */
870 psa
->pvData
= pvNewBlock
;
874 /************************************************************************
875 * Used to set the fFeatures data member of the SAFEARRAY structure.
877 static INT
getFeatures(
881 case VT_UNKNOWN
: return FADF_UNKNOWN
;
882 case VT_DISPATCH
: return FADF_DISPATCH
;
883 case VT_BSTR
: return FADF_BSTR
;
888 /************************************************************************
889 * Used to figure out if the fFeatures data member of the SAFEARRAY
890 * structure contain any information about the type of data stored...
892 static BOOL
isPointer(
896 case FADF_UNKNOWN
: return TRUE
; /* those are pointers */
897 case FADF_DISPATCH
: return TRUE
;
902 /************************************************************************
903 * Used to calculate the displacement when accessing or modifying
904 * safearray data set.
906 * Parameters: - LONG *coor is the desired location in the multidimension
907 * table. Ex for a 3 dim table: coor[] = {1,2,3};
908 * - ULONG *mat is the format of the table. Ex for a 3 dim
909 * table mat[] = {4,4,4};
910 * - USHORT dim is the number of dimension of the SafeArray
912 static ULONG
calcDisplacement(
920 for(iterDim
=0; iterDim
<dim
; iterDim
++)
921 /* the -mat[dim] bring coor[dim] relative to 0 for calculation */
922 res
+= ((coor
[iterDim
]-mat
[iterDim
].lLbound
) *
923 endOfDim(coor
, mat
, iterDim
+1, dim
));
925 TRACE("SafeArray: calculated displacement is %lu.\n", res
);
929 /************************************************************************
930 * Recursivity agent for calcDisplacement method. Used within Put and
942 return (endOfDim(coor
, mat
, dim
+1, realDim
) * mat
[dim
].cElements
);
946 /************************************************************************
947 * Method used to validate the coordinate received in Put and Get
950 static BOOL
validCoordinate(
959 for(; iter
<psa
->cDims
; iter
++) {
960 if((hRes
= SafeArrayGetLBound(psa
, (iter
+1), &lLBound
)) != S_OK
)
962 if((hRes
= SafeArrayGetUBound(psa
, (iter
+1), &lUBound
)) != S_OK
)
965 if(lLBound
== lUBound
)
968 if((coor
[iter
] >= lLBound
) && (coor
[iter
] <= lUBound
))
976 /************************************************************************
977 * Method used to calculate the number of cells of the SA
979 static ULONG
getArraySize(
983 ULONG ulWholeArraySize
= 1;
985 for(cCount
=0; cCount
< psa
->cDims
; cCount
++) /* foreach dimensions... */
986 ulWholeArraySize
*= psa
->rgsabound
[cCount
].cElements
;
988 return ulWholeArraySize
;
992 /************************************************************************
993 * Method used to handle data space dupplication for Copy32 and CopyData32
995 static HRESULT
duplicateData(
999 ULONG ulWholeArraySize
; /* size of the thing */
1002 BSTR pbstrReAllocStr
= NULL
; /* BSTR reallocated */
1004 ulWholeArraySize
= getArraySize(psa
); /* Number of item in SA */
1006 SafeArrayLock(*ppsaOut
);
1008 if( isPointer(psa
->fFeatures
) ) { /* If datatype is object increment
1009 object's reference count */
1011 for(lDelta
=0; lDelta
< ulWholeArraySize
; lDelta
++) {
1012 punk
= *(IUnknown
**)((char *) psa
->pvData
+(lDelta
* psa
->cbElements
));
1015 IUnknown_AddRef(punk
);
1018 /* Copy the source array data into target array */
1019 memcpy((*ppsaOut
)->pvData
, psa
->pvData
,
1020 ulWholeArraySize
*psa
->cbElements
);
1022 } else if( psa
->fFeatures
& FADF_BSTR
) { /* if datatype is BSTR allocate
1023 the BSTR in the new array */
1025 for(lDelta
=0; lDelta
< ulWholeArraySize
; lDelta
++) {
1026 if(( pbstrReAllocStr
= SysAllocString(
1027 *(BSTR
*)((char *) psa
->pvData
+(lDelta
* psa
->cbElements
)))) == NULL
) {
1029 SafeArrayUnlock(*ppsaOut
);
1030 return E_OUTOFMEMORY
;
1033 *((BSTR
*)((char *) (*ppsaOut
)->pvData
+(lDelta
* psa
->cbElements
))) =
1037 } else { /* Simply copy the source array data into target array */
1039 memcpy((*ppsaOut
)->pvData
, psa
->pvData
,
1040 ulWholeArraySize
*psa
->cbElements
);
1043 SafeArrayUnlock(*ppsaOut
);
1049 /************************************************************************
1050 * SafeArrayGetVarType
1051 * Returns the VARTYPE stored in the given safearray
1053 HRESULT WINAPI
SafeArrayGetVarType(
1057 HRESULT hr
= E_INVALIDARG
;
1058 VARTYPE vt
= VT_EMPTY
;
1060 /* const short VARTYPE_OFFSET = -4; */
1062 if (psa
->fFeatures
& FADF_HAVEVARTYPE
)
1064 /* VT tag @ negative offset 4 in the array descriptor */
1065 FIXME("Returning VT_BSTR instead of VT_...");
1068 else if (psa
->fFeatures
& FADF_RECORD
)
1072 else if (psa
->fFeatures
& FADF_DISPATCH
)
1076 else if (psa
->fFeatures
& FADF_UNKNOWN
)
1087 TRACE("HRESULT = %08lx", hr
);