4 * Copyright 1999, 2000 Marcus Meissner
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.
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.
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
38 #include "wine/debug.h"
40 WINE_DEFAULT_DEBUG_CHANNEL(ole
);
42 /* The OLE Automation ProxyStub Interface Class (aka Typelib Marshaler) */
43 extern const GUID CLSID_PSOAInterface
;
45 /* IDispatch marshaler */
46 extern const GUID CLSID_PSDispatch
;
48 static BOOL BSTR_bCache
= TRUE
; /* Cache allocations to minimise alloc calls? */
50 HMODULE OLEAUT32_hModule
= NULL
;
52 /******************************************************************************
56 * BSTR is a simple typedef for a wide-character string used as the principle
57 * string type in ole automation. When encapsulated in a Variant type they are
58 * automatically copied and destroyed as the variant is processed.
60 * The low level BSTR Api allows manipulation of these strings and is used by
61 * higher level Api calls to manage the strings transparently to the caller.
63 * Internally the BSTR type is allocated with space for a DWORD byte count before
64 * the string data begins. This is undocumented and non-system code should not
65 * access the count directly. Use SysStringLen() or SysStringByteLen()
66 * instead. Note that the byte count does not include the terminating NUL.
68 * To create a new BSTR, use SysAllocString(), SysAllocStringLen() or
69 * SysAllocStringByteLen(). To change the size of an existing BSTR, use SysReAllocString()
70 * or SysReAllocStringLen(). Finally to destroy a string use SysFreeString().
72 * BSTR's are cached by Ole Automation by default. To override this behaviour
73 * either set the environment variable 'OANOCACHE', or call SetOaNoCache().
76 * 'Inside OLE, second edition' by Kraig Brockshmidt.
79 /******************************************************************************
80 * SysStringLen [OLEAUT32.7]
82 * Get the allocated length of a BSTR in wide characters.
85 * str [I] BSTR to find the length of
88 * The allocated length of str, or 0 if str is NULL.
92 * The returned length may be different from the length of the string as
93 * calculated by lstrlenW(), since it returns the length that was used to
94 * allocate the string by SysAllocStringLen().
96 UINT WINAPI
SysStringLen(BSTR str
)
102 * The length of the string (in bytes) is contained in a DWORD placed
103 * just before the BSTR pointer
105 bufferPointer
= (DWORD
*)str
;
109 return (int)(*bufferPointer
/sizeof(WCHAR
));
112 /******************************************************************************
113 * SysStringByteLen [OLEAUT32.149]
115 * Get the allocated length of a BSTR in bytes.
118 * str [I] BSTR to find the length of
121 * The allocated length of str, or 0 if str is NULL.
124 * See SysStringLen(), BSTR().
126 UINT WINAPI
SysStringByteLen(BSTR str
)
128 DWORD
* bufferPointer
;
132 * The length of the string (in bytes) is contained in a DWORD placed
133 * just before the BSTR pointer
135 bufferPointer
= (DWORD
*)str
;
139 return (int)(*bufferPointer
);
142 /******************************************************************************
143 * SysAllocString [OLEAUT32.2]
145 * Create a BSTR from an OLESTR.
148 * str [I] Source to create BSTR from
151 * Success: A BSTR allocated with SysAllocStringLen().
152 * Failure: NULL, if oleStr is NULL.
156 * MSDN (October 2001) incorrectly states that NULL is returned if oleStr has
157 * a length of 0. Native Win32 and this implementation both return a valid
158 * empty BSTR in this case.
160 BSTR WINAPI
SysAllocString(LPCOLESTR str
)
164 /* Delegate this to the SysAllocStringLen32 method. */
165 return SysAllocStringLen(str
, lstrlenW(str
));
168 /******************************************************************************
169 * SysFreeString [OLEAUT32.6]
174 * str [I] BSTR to free.
181 * str may be NULL, in which case this function does nothing.
183 void WINAPI
SysFreeString(BSTR str
)
185 DWORD
* bufferPointer
;
187 /* NULL is a valid parameter */
191 * We have to be careful when we free a BSTR pointer, it points to
192 * the beginning of the string but it skips the byte count contained
195 bufferPointer
= (DWORD
*)str
;
200 * Free the memory from its "real" origin.
202 HeapFree(GetProcessHeap(), 0, bufferPointer
);
205 /******************************************************************************
206 * SysAllocStringLen [OLEAUT32.4]
208 * Create a BSTR from an OLESTR of a given wide character length.
211 * str [I] Source to create BSTR from
212 * len [I] Length of oleStr in wide characters
215 * Success: A newly allocated BSTR from SysAllocStringByteLen()
216 * Failure: NULL, if len is >= 0x80000000, or memory allocation fails.
219 * See BSTR(), SysAllocStringByteLen().
221 BSTR WINAPI
SysAllocStringLen(const OLECHAR
*str
, unsigned int len
)
228 * Find the length of the buffer passed-in in bytes.
230 bufferSize
= len
* sizeof (WCHAR
);
233 * Allocate a new buffer to hold the string.
234 * don't forget to keep an empty spot at the beginning of the
235 * buffer for the character count and an extra character at the
238 newBuffer
= HeapAlloc(GetProcessHeap(), 0,
239 bufferSize
+ sizeof(WCHAR
) + sizeof(DWORD
));
242 * If the memory allocation failed, return a null pointer.
248 * Copy the length of the string in the placeholder.
250 *newBuffer
= bufferSize
;
253 * Skip the byte count.
258 * Copy the information in the buffer.
259 * Since it is valid to pass a NULL pointer here, we'll initialize the
260 * buffer to nul if it is the case.
263 memcpy(newBuffer
, str
, bufferSize
);
265 memset(newBuffer
, 0, bufferSize
);
268 * Make sure that there is a nul character at the end of the
271 stringBuffer
= (WCHAR
*)newBuffer
;
272 stringBuffer
[len
] = L
'\0';
274 return (LPWSTR
)stringBuffer
;
277 /******************************************************************************
278 * SysReAllocStringLen [OLEAUT32.5]
280 * Change the length of a previously created BSTR.
283 * old [O] BSTR to change the length of
284 * str [I] New source for pbstr
285 * len [I] Length of oleStr in wide characters
288 * Success: 1. The size of pbstr is updated.
289 * Failure: 0, if len >= 0x80000000 or memory allocation fails.
292 * See BSTR(), SysAllocStringByteLen().
293 * *pbstr may be changed by this function.
295 int WINAPI
SysReAllocStringLen(BSTR
* old
, const OLECHAR
* str
, unsigned int len
)
298 DWORD newbytelen
= len
*sizeof(WCHAR
);
299 DWORD
*ptr
= HeapReAlloc(GetProcessHeap(),0,((DWORD
*)*old
)-1,newbytelen
+sizeof(WCHAR
)+sizeof(DWORD
));
300 *old
= (BSTR
)(ptr
+1);
303 memcpy(*old
, str
, newbytelen
);
306 /* Subtle hidden feature: The old string data is still there
308 * Some Microsoft program needs it.
313 * Allocate the new string
315 *old
= SysAllocStringLen(str
, len
);
321 /******************************************************************************
322 * SysAllocStringByteLen [OLEAUT32.150]
324 * Create a BSTR from an OLESTR of a given byte length.
327 * str [I] Source to create BSTR from
328 * len [I] Length of oleStr in bytes
331 * Success: A newly allocated BSTR
332 * Failure: NULL, if len is >= 0x80000000, or memory allocation fails.
335 * -If len is 0 or oleStr is NULL the resulting string is empty ("").
336 * -This function always NUL terminates the resulting BSTR.
337 * -oleStr may be either an LPCSTR or LPCOLESTR, since it is copied
338 * without checking for a terminating NUL.
341 BSTR WINAPI
SysAllocStringByteLen(LPCSTR str
, UINT len
)
347 * Allocate a new buffer to hold the string.
348 * don't forget to keep an empty spot at the beginning of the
349 * buffer for the character count and an extra character at the
352 newBuffer
= HeapAlloc(GetProcessHeap(), 0,
353 len
+ sizeof(WCHAR
) + sizeof(DWORD
));
356 * If the memory allocation failed, return a null pointer.
362 * Copy the length of the string in the placeholder.
367 * Skip the byte count.
372 * Copy the information in the buffer.
373 * Since it is valid to pass a NULL pointer here, we'll initialize the
374 * buffer to nul if it is the case.
377 memcpy(newBuffer
, str
, len
);
380 * Make sure that there is a nul character at the end of the
383 stringBuffer
= (char *)newBuffer
;
384 stringBuffer
[len
] = 0;
385 stringBuffer
[len
+1] = 0;
387 return (LPWSTR
)stringBuffer
;
390 /******************************************************************************
391 * SysReAllocString [OLEAUT32.3]
393 * Change the length of a previously created BSTR.
396 * old [I/O] BSTR to change the length of
397 * str [I] New source for pbstr
404 * See BSTR(), SysAllocStringStringLen().
406 INT WINAPI
SysReAllocString(LPBSTR old
,LPCOLESTR str
)
415 * Make sure we free the old string.
421 * Allocate the new string
423 *old
= SysAllocString(str
);
428 /******************************************************************************
429 * SetOaNoCache (OLEAUT32.327)
431 * Instruct Ole Automation not to cache BSTR allocations.
442 void WINAPI
SetOaNoCache(void)
447 static WCHAR _delimiter
[2] = {'!',0}; /* default delimiter apparently */
448 static WCHAR
*pdelimiter
= &_delimiter
[0];
450 /***********************************************************************
451 * RegisterActiveObject (OLEAUT32.33)
453 HRESULT WINAPI
RegisterActiveObject(
454 LPUNKNOWN punk
,REFCLSID rcid
,DWORD dwFlags
,LPDWORD pdwRegister
458 LPRUNNINGOBJECTTABLE runobtable
;
461 StringFromGUID2(rcid
,guidbuf
,39);
462 ret
= CreateItemMoniker(pdelimiter
,guidbuf
,&moniker
);
465 ret
= GetRunningObjectTable(0,&runobtable
);
467 IMoniker_Release(moniker
);
470 ret
= IRunningObjectTable_Register(runobtable
,dwFlags
,punk
,moniker
,pdwRegister
);
471 IRunningObjectTable_Release(runobtable
);
472 IMoniker_Release(moniker
);
476 /***********************************************************************
477 * RevokeActiveObject (OLEAUT32.34)
479 HRESULT WINAPI
RevokeActiveObject(DWORD xregister
,LPVOID reserved
)
481 LPRUNNINGOBJECTTABLE runobtable
;
484 ret
= GetRunningObjectTable(0,&runobtable
);
485 if (FAILED(ret
)) return ret
;
486 ret
= IRunningObjectTable_Revoke(runobtable
,xregister
);
487 if (SUCCEEDED(ret
)) ret
= S_OK
;
488 IRunningObjectTable_Release(runobtable
);
492 /***********************************************************************
493 * GetActiveObject (OLEAUT32.35)
495 HRESULT WINAPI
GetActiveObject(REFCLSID rcid
,LPVOID preserved
,LPUNKNOWN
*ppunk
)
499 LPRUNNINGOBJECTTABLE runobtable
;
502 StringFromGUID2(rcid
,guidbuf
,39);
503 ret
= CreateItemMoniker(pdelimiter
,guidbuf
,&moniker
);
506 ret
= GetRunningObjectTable(0,&runobtable
);
508 IMoniker_Release(moniker
);
511 ret
= IRunningObjectTable_GetObject(runobtable
,moniker
,ppunk
);
512 IRunningObjectTable_Release(runobtable
);
513 IMoniker_Release(moniker
);
518 /***********************************************************************
519 * OaBuildVersion [OLEAUT32.170]
521 * Get the Ole Automation build version.
530 * Known oleaut32.dll versions:
531 *| OLE Ver. Comments Date Build Ver.
532 *| -------- ------------------------- ---- ---------
533 *| OLE 2.1 NT 1993-95 10 3023
535 *| Win32s Ver 1.1e 20 4049
536 *| OLE 2.20 W95/NT 1993-96 20 4112
537 *| OLE 2.20 W95/NT 1993-96 20 4118
538 *| OLE 2.20 W95/NT 1993-96 20 4122
539 *| OLE 2.30 W95/NT 1993-98 30 4265
540 *| OLE 2.40 NT?? 1993-98 40 4267
541 *| OLE 2.40 W98 SE orig. file 1993-98 40 4275
542 *| OLE 2.40 W2K orig. file 1993-XX 40 4514
544 * Currently the versions returned are 2.20 for Win3.1, 2.30 for Win95 & NT 3.51,
545 * and 2.40 for all later versions. The build number is maximum, i.e. 0xffff.
547 ULONG WINAPI
OaBuildVersion()
549 switch(GetVersion() & 0x8000ffff) /* mask off build number */
551 case 0x80000a03: /* WIN31 */
552 return MAKELONG(0xffff, 20);
553 case 0x00003303: /* NT351 */
554 return MAKELONG(0xffff, 30);
555 case 0x80000004: /* WIN95; I'd like to use the "standard" w95 minor
556 version here (30), but as we still use w95
557 as default winver (which is good IMHO), I better
558 play safe and use the latest value for w95 for now.
559 Change this as soon as default winver gets changed
560 to something more recent */
561 case 0x80000a04: /* WIN98 */
562 case 0x00000004: /* NT40 */
563 case 0x00000005: /* W2K */
564 case 0x00000105: /* WinXP */
565 return MAKELONG(0xffff, 40);
567 FIXME("Version value not known yet. Please investigate it !\n");
568 return MAKELONG(0xffff, 40); /* for now return the same value as for w2k */
572 /******************************************************************************
573 * OleTranslateColor [OLEAUT32.421]
575 * Convert an OLE_COLOR to a COLORREF.
578 * clr [I] Color to convert
579 * hpal [I] Handle to a palette for the conversion
580 * pColorRef [O] Destination for converted color, or NULL to test if the conversion is ok
583 * Success: S_OK. The conversion is ok, and pColorRef contains the converted color if non-NULL.
584 * Failure: E_INVALIDARG, if any argument is invalid.
587 * Document the conversion rules.
589 HRESULT WINAPI
OleTranslateColor(
595 BYTE b
= HIBYTE(HIWORD(clr
));
597 TRACE("(%08lx, %p, %p):stub\n", clr
, hpal
, pColorRef
);
600 * In case pColorRef is NULL, provide our own to simplify the code.
602 if (pColorRef
== NULL
)
603 pColorRef
= &colorref
;
610 *pColorRef
= PALETTERGB(GetRValue(clr
),
625 * Validate the palette index.
627 if (GetPaletteEntries(hpal
, LOWORD(clr
), 1, &pe
) == 0)
642 int index
= LOBYTE(LOWORD(clr
));
645 * Validate GetSysColor index.
647 if ((index
< COLOR_SCROLLBAR
) || (index
> COLOR_MENUBAR
))
650 *pColorRef
= GetSysColor(index
);
662 extern HRESULT
OLEAUTPS_DllGetClassObject(REFCLSID rclsid
, REFIID riid
, LPVOID
*ppv
);
664 extern void _get_STDFONT_CF(LPVOID
);
665 extern void _get_STDPIC_CF(LPVOID
);
667 /***********************************************************************
668 * DllGetClassObject (OLEAUT32.1)
670 HRESULT WINAPI
OLEAUT32_DllGetClassObject(REFCLSID rclsid
, REFIID iid
, LPVOID
*ppv
)
673 if (IsEqualGUID(rclsid
,&CLSID_StdFont
)) {
674 if (IsEqualGUID(iid
,&IID_IClassFactory
)) {
675 _get_STDFONT_CF(ppv
);
676 IClassFactory_AddRef((IClassFactory
*)*ppv
);
680 if (IsEqualGUID(rclsid
,&CLSID_StdPicture
)) {
681 if (IsEqualGUID(iid
,&IID_IClassFactory
)) {
683 IClassFactory_AddRef((IClassFactory
*)*ppv
);
687 if (IsEqualGUID(rclsid
,&CLSID_PSDispatch
)) {
688 return OLEAUTPS_DllGetClassObject(rclsid
,iid
,ppv
);
690 if (IsEqualGUID(rclsid
,&CLSID_PSOAInterface
)) {
691 if (S_OK
==TypeLibFac_DllGetClassObject(rclsid
,iid
,ppv
))
695 FIXME("\n\tCLSID:\t%s,\n\tIID:\t%s\n",debugstr_guid(rclsid
),debugstr_guid(iid
));
696 return CLASS_E_CLASSNOTAVAILABLE
;
699 /***********************************************************************
700 * DllCanUnloadNow (OLEAUT32.410)
702 * Determine if this dll can be unloaded from the callers address space.
708 * Always returns S_FALSE. This dll cannot be unloaded.
710 HRESULT WINAPI
OLEAUT32_DllCanUnloadNow(void)
715 /*****************************************************************************
716 * DllMain [OLEAUT32.@]
718 BOOL WINAPI
DllMain(HINSTANCE hInstDll
, DWORD fdwReason
, LPVOID lpvReserved
)
720 TRACE("(%p,%lu,%p)\n", hInstDll
, fdwReason
, lpvReserved
);
723 case DLL_PROCESS_ATTACH
:
724 DisableThreadLibraryCalls(hInstDll
);
725 OLEAUT32_hModule
= (HMODULE
)hInstDll
;
727 case DLL_PROCESS_DETACH
: