Remove two ancient FAQ entries that did more harm than good.
[wine.git] / dlls / oleaut32 / typelib16.c
blob01abb2d9dd812c3a3d18b67a6ac5cf72fdb88ad3
1 /*
2 * TYPELIB 16bit part.
4 * Copyright 1997 Marcus Meissner
5 * Copyright 1999 Rein Klazes
6 * Copyright 2000 Francois Jacques
7 * Copyright 2001 Huw D M Davies for CodeWeavers
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.
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.
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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
24 #include "config.h"
25 #include "wine/port.h"
27 #include <stdlib.h>
28 #include <string.h>
29 #include <stdarg.h>
30 #include <stdio.h>
31 #include <ctype.h>
33 #include "winerror.h"
34 #include "windef.h"
35 #include "winbase.h"
36 #include "winnls.h"
37 #include "winreg.h"
38 #include "winuser.h"
40 #include "objbase.h"
41 #include "ole2disp.h"
42 #include "wine/debug.h"
44 WINE_DEFAULT_DEBUG_CHANNEL(ole);
46 /*************************************************************************
47 * TYPELIB {TYPELIB}
49 * This dll is the 16 bit version of the Typelib API, part the original
50 * implementation of Ole automation. It and its companion ole2disp.dll were
51 * superseded by oleaut32.dll which provides 32 bit implementations of these
52 * functions and greatly extends the Ole Api.
54 * Winelib developers cannot use these functions directly, they are implemented
55 * solely for backwards compatibility with existing legacy applications.
57 * SEE ALSO
58 * oleaut32(), ole2disp().
61 /****************************************************************************
62 * QueryPathOfRegTypeLib [TYPELIB.14]
64 * Get the registry key of a registered type library.
66 * RETURNS
67 * Success: S_OK. path is updated with the key name
68 * Failure: E_FAIL, if guid was not found in the registry
70 * NOTES
71 * The key takes the form "Classes\Typelib\<guid>\<major>.<minor>\<lcid>\win16\"
73 HRESULT WINAPI
74 QueryPathOfRegTypeLib16(
75 REFGUID guid, /* [in] Guid to get the key name for */
76 WORD wMaj, /* [in] Major version */
77 WORD wMin, /* [in] Minor version */
78 LCID lcid, /* [in] Locale Id */
79 LPBSTR16 path) /* [out] Destination for the registry key name */
81 char xguid[80];
82 char typelibkey[100],pathname[260];
83 DWORD plen;
85 TRACE("\n");
87 if (HIWORD(guid)) {
88 sprintf( typelibkey, "SOFTWARE\\Classes\\Typelib\\{%08lx-%04x-%04x-%02x%02x-%02x%02x%02x%02x%02x%02x}\\%d.%d\\%lx\\win16",
89 guid->Data1, guid->Data2, guid->Data3,
90 guid->Data4[0], guid->Data4[1], guid->Data4[2], guid->Data4[3],
91 guid->Data4[4], guid->Data4[5], guid->Data4[6], guid->Data4[7],
92 wMaj,wMin,lcid);
93 } else {
94 sprintf(xguid,"<guid 0x%08lx>",(DWORD)guid);
95 FIXME("(%s,%d,%d,0x%04lx,%p),can't handle non-string guids.\n",xguid,wMaj,wMin,(DWORD)lcid,path);
96 return E_FAIL;
98 plen = sizeof(pathname);
99 if (RegQueryValueA(HKEY_LOCAL_MACHINE,typelibkey,pathname,&plen)) {
100 /* try again without lang specific id */
101 if (SUBLANGID(lcid))
102 return QueryPathOfRegTypeLib16(guid,wMaj,wMin,PRIMARYLANGID(lcid),path);
103 FIXME("key %s not found\n",typelibkey);
104 return E_FAIL;
106 *path = SysAllocString16(pathname);
107 return S_OK;
110 /******************************************************************************
111 * LoadTypeLib [TYPELIB.3]
113 * Load and register a type library.
115 * RETURNS
116 * Success: S_OK. pptLib contains the type libraries ITypeLib interface.
117 * Failure: An HRESULT error code.
119 * NOTES
120 * Both parameters are FAR pointers.
122 HRESULT WINAPI LoadTypeLib16(
123 LPOLESTR szFile, /* [in] Name of file to load from */
124 ITypeLib** pptLib) /* [out] Destination for loaded ITypeLib interface */
126 FIXME("(%s,%p): stub\n",debugstr_w((LPWSTR)szFile),pptLib);
128 if (pptLib!=0)
129 *pptLib=0;
131 return E_FAIL;
134 /****************************************************************************
135 * OaBuildVersion (TYPELIB.15)
137 * Get the Ole Automation build version.
139 * PARAMS
140 * None
142 * RETURNS
143 * The build version.
145 * NOTES
146 * Known typelib.dll versions:
147 *| OLE Ver. Comments Date Build Ver.
148 *| -------- ------------------------- ---- ---------
149 *| OLE 2.01 Call not available 1993 N/A
150 *| OLE 2.02 1993-94 02 3002
151 *| OLE 2.03 23 730
152 *| OLE 2.03 03 3025
153 *| OLE 2.03 W98 SE orig. file !! 1993-95 10 3024
154 *| OLE 2.1 NT 1993-95 ?? ???
155 *| OLE 2.3.1 W95 23 700
156 *| OLE2 4.0 NT4SP6 1993-98 40 4277
158 DWORD WINAPI OaBuildVersion16(void)
160 /* FIXME: I'd like to return the highest currently known version value
161 * in case the user didn't force a --winver, but I don't know how
162 * to retrieve the "versionForced" info from misc/version.c :(
163 * (this would be useful in other places, too) */
164 FIXME("If you get version error messages, please report them\n");
165 switch(GetVersion() & 0x8000ffff) /* mask off build number */
167 case 0x80000a03: /* WIN31 */
168 return MAKELONG(3027, 3); /* WfW 3.11 */
169 case 0x80000004: /* WIN95 */
170 return MAKELONG(700, 23); /* Win95A */
171 case 0x80000a04: /* WIN98 */
172 return MAKELONG(3024, 10); /* W98 SE */
173 case 0x00000004: /* NT4 */
174 return MAKELONG(4277, 40); /* NT4 SP6 */
175 default:
176 FIXME("Version value not known yet. Please investigate it!\n");
177 return 0;