blob: c86d2bb4754950eed0b58f5c7dd392d83b1bfc45 [file] [log] [blame]
Guido van Rossum9f3712c2000-03-28 20:37:15 +00001/*
Fred Drake270e19b2000-06-29 16:14:14 +00002 _winreg.c
Guido van Rossum9f3712c2000-03-28 20:37:15 +00003
4 Windows Registry access module for Python.
5
6 * Simple registry access written by Mark Hammond in win32api
7 module circa 1995.
8 * Bill Tutt expanded the support significantly not long after.
9 * Numerous other people have submitted patches since then.
10 * Ripped from win32api module 03-Feb-2000 by Mark Hammond, and
11 basic Unicode support added.
12
13*/
14
15#include "windows.h"
16#include "Python.h"
17#include "structmember.h"
18#include "malloc.h" /* for alloca */
19
20static BOOL PyHKEY_AsHKEY(PyObject *ob, HKEY *pRes, BOOL bNoneOK);
21static PyObject *PyHKEY_FromHKEY(HKEY h);
22static BOOL PyHKEY_Close(PyObject *obHandle);
23
24static char errNotAHandle[] = "Object is not a handle";
25
26/* The win32api module reports the function name that failed,
27 but this concept is not in the Python core.
28 Hopefully it will one day, and in the meantime I dont
29 want to lose this info...
30*/
31#define PyErr_SetFromWindowsErrWithFunction(rc, fnname) \
32 PyErr_SetFromWindowsErr(rc)
33
34/* Forward declares */
35
36/* Doc strings */
37static char module_doc[] =
38"This module provides access to the Windows registry API.\n"
39"\n"
40"Functions:\n"
41"\n"
42"CloseKey() - Closes a registry key.\n"
43"ConnectRegistry() - Establishes a connection to a predefined registry handle\n"
44" on another computer.\n"
45"CreateKey() - Creates the specified key, or opens it if it already exists.\n"
46"DeleteKey() - Deletes the specified key.\n"
47"DeleteValue() - Removes a named value from the specified registry key.\n"
48"EnumKey() - Enumerates subkeys of the specified open registry key.\n"
49"EnumValue() - Enumerates values of the specified open registry key.\n"
50"FlushKey() - Writes all the attributes of the specified key to the registry.\n"
51"LoadKey() - Creates a subkey under HKEY_USER or HKEY_LOCAL_MACHINE and stores\n"
52" registration information from a specified file into that subkey.\n"
53"OpenKey() - Alias for <om win32api.RegOpenKeyEx>\n"
54"OpenKeyEx() - Opens the specified key.\n"
55"QueryValue() - Retrieves the value associated with the unnamed value for a\n"
56" specified key in the registry.\n"
57"QueryValueEx() - Retrieves the type and data for a specified value name\n"
58" associated with an open registry key.\n"
59"QueryInfoKey() - Returns information about the specified key.\n"
60"SaveKey() - Saves the specified key, and all its subkeys a file.\n"
61"SetValue() - Associates a value with a specified key.\n"
62"SetValueEx() - Stores data in the value field of an open registry key.\n"
63"\n"
64"Special objects:\n"
65"\n"
66"HKEYType -- type object for HKEY objects\n"
67"error -- exception raised for Win32 errors\n"
68"\n"
69"Integer constants:\n"
70"Many constants are defined - see the documentation for each function\n"
71"to see what constants are used, and where.";
72
73
74static char CloseKey_doc[] =
75"CloseKey(hkey) - Closes a previously opened registry key.\n"
76"\n"
77"The hkey argument specifies a previously opened key.\n"
78"\n"
79"Note that if the key is not closed using this method, it will be\n"
80"closed when the hkey object is destroyed by Python.";
81
82static char ConnectRegistry_doc[] =
83"key = ConnectRegistry(computer_name, key) - "
84"Establishes a connection to a predefined registry handle on another computer.\n"
85"\n"
86"computer_name is the name of the remote computer, of the form \\\\computername.\n"
87" If None, the local computer is used.\n"
88"key is the predefined handle to connect to.\n"
89"\n"
90"The return value is the handle of the opened key.\n"
Mark Hammondb422f952000-06-09 06:01:47 +000091"If the function fails, an EnvironmentError exception is raised.";
Guido van Rossum9f3712c2000-03-28 20:37:15 +000092
93static char CreateKey_doc[] =
94"key = CreateKey(key, sub_key) - Creates or opens the specified key.\n"
95"\n"
96"key is an already open key, or one of the predefined HKEY_* constants\n"
97"sub_key is a string that names the key this method opens or creates.\n"
98" If key is one of the predefined keys, sub_key may be None. In that case,\n"
99" the handle returned is the same key handle passed in to the function.\n"
100"\n"
101"If the key already exists, this function opens the existing key\n"
102"\n"
103"The return value is the handle of the opened key.\n"
104"If the function fails, an exception is raised.";
105
106static char DeleteKey_doc[] =
107"DeleteKey(key, sub_key) - Deletes the specified key.\n"
108"\n"
109"key is an already open key, or any one of the predefined HKEY_* constants.\n"
110"sub_key is a string that must be a subkey of the key identified by the key parameter.\n"
111" This value must not be None, and the key may not have subkeys.\n"
112"\n"
113"This method can not delete keys with subkeys.\n"
114"\n"
115"If the method succeeds, the entire key, including all of its values,\n"
Mark Hammondb422f952000-06-09 06:01:47 +0000116"is removed. If the method fails, an EnvironmentError exception is raised.";
Guido van Rossum9f3712c2000-03-28 20:37:15 +0000117
118static char DeleteValue_doc[] =
119"DeleteValue(key, value) - Removes a named value from a registry key.\n"
120"\n"
121"key is an already open key, or any one of the predefined HKEY_* constants.\n"
122"value is a string that identifies the value to remove.";
123
124static char EnumKey_doc[] =
125"string = EnumKey(key, index) - Enumerates subkeys of an open registry key.\n"
126"\n"
127"key is an already open key, or any one of the predefined HKEY_* constants.\n"
128"index is an integer that identifies the index of the key to retrieve.\n"
129"\n"
130"The function retrieves the name of one subkey each time it is called.\n"
Mark Hammondb422f952000-06-09 06:01:47 +0000131"It is typically called repeatedly until an EnvironmentError exception is\n"
132"raised, indicating no more values are available.\n";
Guido van Rossum9f3712c2000-03-28 20:37:15 +0000133
134static char EnumValue_doc[] =
135"tuple = EnumValue(key, index) - Enumerates values of an open registry key.\n"
136"key is an already open key, or any one of the predefined HKEY_* constants.\n"
137"index is an integer that identifies the index of the value to retrieve.\n"
138"\n"
139"The function retrieves the name of one subkey each time it is called.\n"
Mark Hammondb422f952000-06-09 06:01:47 +0000140"It is typically called repeatedly, until an EnvironmentError exception\n"
141"is raised, indicating no more values.\n"
Guido van Rossum9f3712c2000-03-28 20:37:15 +0000142"\n"
143"The result is a tuple of 3 items:\n"
144"value_name is a string that identifies the value.\n"
145"value_data is an object that holds the value data, and whose type depends\n"
146" on the underlying registry type.\n"
147"data_type is an integer that identifies the type of the value data.";
148
149static char FlushKey_doc[] =
150"FlushKey(key) - Writes all the attributes of a key to the registry.\n"
151"\n"
152"key is an already open key, or any one of the predefined HKEY_* constants.\n"
153"\n"
154"It is not necessary to call RegFlushKey to change a key.\n"
155"Registry changes are flushed to disk by the registry using its lazy flusher.\n"
156"Registry changes are also flushed to disk at system shutdown.\n"
157"Unlike CloseKey(), the FlushKey() method returns only when all the data has\n"
158"been written to the registry.\n"
159"An application should only call FlushKey() if it requires absolute certainty that registry changes are on disk.\n"
160"If you don't know whether a FlushKey() call is required, it probably isn't.\n";
161
162static char LoadKey_doc[] =
Mark Hammondb422f952000-06-09 06:01:47 +0000163"LoadKey(key, sub_key, file_name) - Creates a subkey under the specified key\n"
Guido van Rossum9f3712c2000-03-28 20:37:15 +0000164"and stores registration information from a specified file into that subkey.\n"
165"\n"
166"key is an already open key, or any one of the predefined HKEY_* constants.\n"
167"sub_key is a string that identifies the sub_key to load\n"
168"file_name is the name of the file to load registry data from.\n"
169" This file must have been created with the SaveKey() function.\n"
170" Under the file allocation table (FAT) file system, the filename may not\n"
171"have an extension.\n"
172"\n"
173"A call to LoadKey() fails if the calling process does not have the\n"
174"SE_RESTORE_PRIVILEGE privilege.\n"
175"\n"
176"If key is a handle returned by ConnectRegistry(), then the path specified\n"
177"in fileName is relative to the remote computer.\n"
178"\n"
179"The docs imply key must be in the HKEY_USER or HKEY_LOCAL_MACHINE tree";
180
181static char OpenKey_doc[] =
182"key = OpenKey(key, sub_key, res = 0, sam = KEY_READ) - Opens the specified key.\n"
183"\n"
184"key is an already open key, or any one of the predefined HKEY_* constants.\n"
185"sub_key is a string that identifies the sub_key to open\n"
186"res is a reserved integer, and must be zero. Default is zero.\n"
187"sam is an integer that specifies an access mask that describes the desired\n"
188" security access for the key. Default is KEY_READ\n"
189"\n"
190"The result is a new handle to the specified key\n"
Mark Hammondb422f952000-06-09 06:01:47 +0000191"If the function fails, an EnvironmentError exception is raised.\n";
Guido van Rossum9f3712c2000-03-28 20:37:15 +0000192
193static char OpenKeyEx_doc[] =
194"See OpenKey()";
195
196static char QueryInfoKey_doc[] =
197"tuple = QueryInfoKey(key) - Returns information about a key.\n"
198"\n"
199"key is an already open key, or any one of the predefined HKEY_* constants.\n"
200"\n"
201"The result is a tuple of 3 items:"
202"An integer that identifies the number of sub keys this key has.\n"
203"An integer that identifies the number of values this key has.\n"
204"A long integer that identifies when the key was last modified (if available)\n"
205" as 100's of nanoseconds since Jan 1, 1600.\n";
206
207static char QueryValue_doc[] =
208"string = QueryValue(key, sub_key) - retrieves the unnamed value for a key.\n"
209"\n"
210"key is an already open key, or any one of the predefined HKEY_* constants.\n"
Mark Hammondb422f952000-06-09 06:01:47 +0000211"sub_key is a string that holds the name of the subkey with which the value\n"
Guido van Rossum9f3712c2000-03-28 20:37:15 +0000212" is associated. If this parameter is None or empty, the function retrieves\n"
213" the value set by the SetValue() method for the key identified by key."
214"\n"
215"Values in the registry have name, type, and data components. This method\n"
216"retrieves the data for a key's first value that has a NULL name.\n"
217"But the underlying API call doesn't return the type, Lame Lame Lame, DONT USE THIS!!!";
218
219static char QueryValueEx_doc[] =
220"value,type_id = QueryValueEx(key, value_name) - Retrieves the type and data for a specified value name associated with an open registry key.\n"
221"\n"
222"key is an already open key, or any one of the predefined HKEY_* constants.\n"
223"value_name is a string indicating the value to query";
224
225static char SaveKey_doc[] =
226"SaveKey(key, file_name) - Saves the specified key, and all its subkeys to the specified file.\n"
227"\n"
228"key is an already open key, or any one of the predefined HKEY_* constants.\n"
229"file_name is the name of the file to save registry data to.\n"
230" This file cannot already exist. If this filename includes an extension,\n"
231" it cannot be used on file allocation table (FAT) file systems by the\n"
232" LoadKey(), ReplaceKey() or RestoreKey() methods.\n"
233"\n"
234"If key represents a key on a remote computer, the path described by\n"
235"file_name is relative to the remote computer.\n"
236"The caller of this method must possess the SeBackupPrivilege security privilege.\n"
237"This function passes NULL for security_attributes to the API.";
238
239static char SetValue_doc[] =
240"SetValue(key, sub_key, type, value) - Associates a value with a specified key.\n"
241"\n"
242"key is an already open key, or any one of the predefined HKEY_* constants.\n"
243"sub_key is a string that names the subkey with which the value is associated.\n"
244"type is an integer that specifies the type of the data. Currently this\n"
245" must be REG_SZ, meaning only strings are supported.\n"
246"value is a string that specifies the new value.\n"
247"\n"
248"If the key specified by the sub_key parameter does not exist, the SetValue\n"
249"function creates it.\n"
250"\n"
251"Value lengths are limited by available memory. Long values (more than\n"
252"2048 bytes) should be stored as files with the filenames stored in \n"
253"the configuration registry. This helps the registry perform efficiently.\n"
254"\n"
255"The key identified by the key parameter must have been opened with\n"
256"KEY_SET_VALUE access.";
257
258static char SetValueEx_doc[] =
259"SetValueEx(key, value_name, reserved, type, value) - Stores data in the value field of an open registry key.\n"
260"\n"
261"key is an already open key, or any one of the predefined HKEY_* constants.\n"
262"sub_key is a string that names the subkey with which the value is associated.\n"
263"type is an integer that specifies the type of the data. This should be one of:\n"
264" REG_BINARY -- Binary data in any form.\n"
265" REG_DWORD -- A 32-bit number.\n"
266" REG_DWORD_LITTLE_ENDIAN -- A 32-bit number in little-endian format.\n"
267" REG_DWORD_BIG_ENDIAN -- A 32-bit number in big-endian format.\n"
268" REG_EXPAND_SZ -- A null-terminated string that contains unexpanded references\n"
269" to environment variables (for example, %PATH%).\n"
270" REG_LINK -- A Unicode symbolic link.\n"
Mark Hammondb422f952000-06-09 06:01:47 +0000271" REG_MULTI_SZ -- An sequence of null-terminated strings, terminated by\n"
272" two null characters. Note that Python handles this\n"
273" termination automatically.\n"
Guido van Rossum9f3712c2000-03-28 20:37:15 +0000274" REG_NONE -- No defined value type.\n"
275" REG_RESOURCE_LIST -- A device-driver resource list.\n"
276" REG_SZ -- A null-terminated string.\n"
277"reserved can be anything - zero is always passed to the API.\n"
278"value is a string that specifies the new value.\n"
279"\n"
280"This method can also set additional value and type information for the\n"
281"specified key. The key identified by the key parameter must have been\n"
282"opened with KEY_SET_VALUE access.\n"
283"\n"
284"To open the key, use the CreateKeyEx() or OpenKeyEx() methods.\n"
285"\n"
286"Value lengths are limited by available memory. Long values (more than\n"
287"2048 bytes) should be stored as files with the filenames stored in \n"
288"the configuration registry. This helps the registry perform efficiently.\n";
289
290/* PyHKEY docstrings */
291static char PyHKEY_doc[] =
292"PyHKEY Object - A Python object, representing a win32 registry key.\n"
293"\n"
Mark Hammondb422f952000-06-09 06:01:47 +0000294"This object wraps a Windows HKEY object, automatically closing it when\n"
Guido van Rossum9f3712c2000-03-28 20:37:15 +0000295"the object is destroyed. To guarantee cleanup, you can call either\n"
296"the Close() method on the PyHKEY, or the CloseKey() method.\n"
297"\n"
298"All functions which accept a handle object also accept an integer - \n"
299"however, use of the handle object is encouraged.\n"
300"\n"
301"Functions:\n"
302"Close() - Closes the underlying handle.\n"
303"Detach() - Returns the integer Win32 handle, detaching it from the object\n"
304"\n"
305"Properties:\n"
306"handle - The integer Win32 handle.\n"
307"\n"
308"Operations:\n"
309"__nonzero__ - Handles with an open object return true, otherwise false.\n"
310"__int__ - Converting a handle to an integer returns the Win32 handle.\n"
311"__cmp__ - Handle objects are compared using the handle value.\n";
312
313
314static char PyHKEY_Close_doc[] =
Mark Hammondb422f952000-06-09 06:01:47 +0000315"key.Close() - Closes the underlying Windows handle.\n"
Guido van Rossum9f3712c2000-03-28 20:37:15 +0000316"\n"
317"If the handle is already closed, no error is raised.";
318
319static char PyHKEY_Detach_doc[] =
Mark Hammondb422f952000-06-09 06:01:47 +0000320"int = key.Detach() - Detaches the Windows handle from the handle object.\n"
Guido van Rossum9f3712c2000-03-28 20:37:15 +0000321"\n"
322"The result is the value of the handle before it is detached. If the\n"
323"handle is already detached, this will return zero.\n"
324"\n"
325"After calling this function, the handle is effectively invalidated,\n"
326"but the handle is not closed. You would call this function when you\n"
327"need the underlying win32 handle to exist beyond the lifetime of the\n"
Mark Hammondb422f952000-06-09 06:01:47 +0000328"handle object.\n"
329"On 64 bit windows, the result of this function is a long integer\n";
Guido van Rossum9f3712c2000-03-28 20:37:15 +0000330
331
332/************************************************************************
333
334 The PyHKEY object definition
335
336************************************************************************/
337typedef struct {
338 PyObject_VAR_HEAD
339 HKEY hkey;
340} PyHKEYObject;
341
342#define PyHKEY_Check(op) ((op)->ob_type == &PyHKEY_Type)
343
344static char *failMsg = "bad operand type";
345
346static PyObject *
347PyHKEY_unaryFailureFunc(PyObject *ob)
348{
349 PyErr_SetString(PyExc_TypeError, failMsg);
350 return NULL;
351}
352static PyObject *
353PyHKEY_binaryFailureFunc(PyObject *ob1, PyObject *ob2)
354{
355 PyErr_SetString(PyExc_TypeError, failMsg);
356 return NULL;
357}
358static PyObject *
359PyHKEY_ternaryFailureFunc(PyObject *ob1, PyObject *ob2, PyObject *ob3)
360{
361 PyErr_SetString(PyExc_TypeError, failMsg);
362 return NULL;
363}
364
365static void
366PyHKEY_deallocFunc(PyObject *ob)
367{
368 /* Can not call PyHKEY_Close, as the ob->tp_type
369 has already been cleared, thus causing the type
370 check to fail!
371 */
372 PyHKEYObject *obkey = (PyHKEYObject *)ob;
373 if (obkey->hkey)
374 RegCloseKey((HKEY)obkey->hkey);
Guido van Rossumb18618d2000-05-03 23:44:39 +0000375 PyObject_DEL(ob);
Guido van Rossum9f3712c2000-03-28 20:37:15 +0000376}
377
378static int
379PyHKEY_nonzeroFunc(PyObject *ob)
380{
381 return ((PyHKEYObject *)ob)->hkey != 0;
382}
383
384static PyObject *
385PyHKEY_intFunc(PyObject *ob)
386{
387 PyHKEYObject *pyhkey = (PyHKEYObject *)ob;
388 return PyLong_FromVoidPtr(pyhkey->hkey);
389}
390
391static int
392PyHKEY_printFunc(PyObject *ob, FILE *fp, int flags)
393{
394 PyHKEYObject *pyhkey = (PyHKEYObject *)ob;
395 char resBuf[160];
396 wsprintf(resBuf, "<PyHKEY at %p (%p)>",
397 ob, pyhkey->hkey);
398 fputs(resBuf, fp);
399 return 0;
400}
401
402static PyObject *
403PyHKEY_strFunc(PyObject *ob)
404{
405 PyHKEYObject *pyhkey = (PyHKEYObject *)ob;
406 char resBuf[160];
407 wsprintf(resBuf, "<PyHKEY:%p>", pyhkey->hkey);
408 return PyString_FromString(resBuf);
409}
410
411static int
412PyHKEY_compareFunc(PyObject *ob1, PyObject *ob2)
413{
414 PyHKEYObject *pyhkey1 = (PyHKEYObject *)ob1;
415 PyHKEYObject *pyhkey2 = (PyHKEYObject *)ob2;
416 return pyhkey1 == pyhkey2 ? 0 :
417 (pyhkey1 < pyhkey2 ? -1 : 1);
418}
419
420static long
421PyHKEY_hashFunc(PyObject *ob)
422{
423 /* Just use the address.
424 XXX - should we use the handle value?
425 */
Fred Drake13634cf2000-06-29 19:17:04 +0000426 return _Py_HashPointer(ob);
Guido van Rossum9f3712c2000-03-28 20:37:15 +0000427}
428
429
430static PyNumberMethods PyHKEY_NumberMethods =
431{
432 PyHKEY_binaryFailureFunc, /* nb_add */
433 PyHKEY_binaryFailureFunc, /* nb_subtract */
434 PyHKEY_binaryFailureFunc, /* nb_multiply */
435 PyHKEY_binaryFailureFunc, /* nb_divide */
436 PyHKEY_binaryFailureFunc, /* nb_remainder */
437 PyHKEY_binaryFailureFunc, /* nb_divmod */
438 PyHKEY_ternaryFailureFunc, /* nb_power */
439 PyHKEY_unaryFailureFunc, /* nb_negative */
440 PyHKEY_unaryFailureFunc, /* nb_positive */
441 PyHKEY_unaryFailureFunc, /* nb_absolute */
442 PyHKEY_nonzeroFunc, /* nb_nonzero */
443 PyHKEY_unaryFailureFunc, /* nb_invert */
444 PyHKEY_binaryFailureFunc, /* nb_lshift */
445 PyHKEY_binaryFailureFunc, /* nb_rshift */
446 PyHKEY_binaryFailureFunc, /* nb_and */
447 PyHKEY_binaryFailureFunc, /* nb_xor */
448 PyHKEY_binaryFailureFunc, /* nb_or */
449 0, /* nb_coerce (allowed to be zero) */
450 PyHKEY_intFunc, /* nb_int */
451 PyHKEY_unaryFailureFunc, /* nb_long */
452 PyHKEY_unaryFailureFunc, /* nb_float */
453 PyHKEY_unaryFailureFunc, /* nb_oct */
454 PyHKEY_unaryFailureFunc, /* nb_hex */
455};
456
457
458/* fwd declare __getattr__ */
459static PyObject *PyHKEY_getattr(PyObject *self, char *name);
460
461/* The type itself */
462PyTypeObject PyHKEY_Type =
463{
464 PyObject_HEAD_INIT(0) /* fill in type at module init */
465 0,
466 "PyHKEY",
467 sizeof(PyHKEYObject),
468 0,
469 PyHKEY_deallocFunc, /* tp_dealloc */
470 PyHKEY_printFunc, /* tp_print */
471 PyHKEY_getattr, /* tp_getattr */
472 0, /* tp_setattr */
473 PyHKEY_compareFunc, /* tp_compare */
474 0, /* tp_repr */
475 &PyHKEY_NumberMethods, /* tp_as_number */
476 0, /* tp_as_sequence */
477 0, /* tp_as_mapping */
478 PyHKEY_hashFunc, /* tp_hash */
479 0, /* tp_call */
480 PyHKEY_strFunc, /* tp_str */
481 0, /* tp_getattro */
482 0, /* tp_setattro */
483 0, /* tp_as_buffer */
484 0, /* tp_flags */
485 PyHKEY_doc, /* tp_doc */
486};
487
488#define OFF(e) offsetof(PyHKEYObject, e)
489
490static struct memberlist PyHKEY_memberlist[] = {
491 {"handle", T_INT, OFF(hkey)},
492 {NULL} /* Sentinel */
493};
494
495/************************************************************************
496
497 The PyHKEY object methods
498
499************************************************************************/
500static PyObject *
501PyHKEY_CloseMethod(PyObject *self, PyObject *args)
502{
503 if (!PyArg_ParseTuple(args, ":Close"))
504 return NULL;
505 if (!PyHKEY_Close(self))
506 return NULL;
507 Py_INCREF(Py_None);
508 return Py_None;
509}
510
511static PyObject *
512PyHKEY_DetachMethod(PyObject *self, PyObject *args)
513{
514 void* ret;
515 PyHKEYObject *pThis = (PyHKEYObject *)self;
516 if (!PyArg_ParseTuple(args, ":Detach"))
517 return NULL;
518 ret = (void*)pThis->hkey;
519 pThis->hkey = 0;
520 return PyLong_FromVoidPtr(ret);
521}
522
523static struct PyMethodDef PyHKEY_methods[] = {
Neal Norwitz031829d2002-03-31 14:37:44 +0000524 {"Close", PyHKEY_CloseMethod, METH_VARARGS, PyHKEY_Close_doc},
525 {"Detach", PyHKEY_DetachMethod, METH_VARARGS, PyHKEY_Detach_doc},
Guido van Rossum9f3712c2000-03-28 20:37:15 +0000526 {NULL}
527};
528
529/*static*/ PyObject *
530PyHKEY_getattr(PyObject *self, char *name)
531{
532 PyObject *res;
533
534 res = Py_FindMethod(PyHKEY_methods, self, name);
535 if (res != NULL)
536 return res;
537 PyErr_Clear();
538 if (strcmp(name, "handle") == 0)
539 return PyLong_FromVoidPtr(((PyHKEYObject *)self)->hkey);
540 return PyMember_Get((char *)self, PyHKEY_memberlist, name);
541}
542
543/************************************************************************
544 The public PyHKEY API (well, not public yet :-)
545************************************************************************/
546PyObject *
547PyHKEY_New(HKEY hInit)
548{
549 PyHKEYObject *key = PyObject_NEW(PyHKEYObject, &PyHKEY_Type);
550 if (key)
551 key->hkey = hInit;
552 return (PyObject *)key;
553}
554
555BOOL
556PyHKEY_Close(PyObject *ob_handle)
557{
558 LONG rc;
559 PyHKEYObject *key;
560
561 if (!PyHKEY_Check(ob_handle)) {
562 PyErr_SetString(PyExc_TypeError, "bad operand type");
563 return FALSE;
564 }
565 key = (PyHKEYObject *)ob_handle;
566 rc = key->hkey ? RegCloseKey((HKEY)key->hkey) : ERROR_SUCCESS;
567 key->hkey = 0;
568 if (rc != ERROR_SUCCESS)
569 PyErr_SetFromWindowsErrWithFunction(rc, "RegCloseKey");
570 return rc == ERROR_SUCCESS;
571}
572
573BOOL
574PyHKEY_AsHKEY(PyObject *ob, HKEY *pHANDLE, BOOL bNoneOK)
575{
576 if (ob == Py_None) {
577 if (!bNoneOK) {
578 PyErr_SetString(
579 PyExc_TypeError,
580 "None is not a valid HKEY in this context");
581 return FALSE;
582 }
583 *pHANDLE = (HKEY)0;
584 }
585 else if (PyHKEY_Check(ob)) {
586 PyHKEYObject *pH = (PyHKEYObject *)ob;
587 *pHANDLE = pH->hkey;
588 }
589 else if (PyInt_Check(ob) || PyLong_Check(ob)) {
590 /* We also support integers */
591 PyErr_Clear();
592 *pHANDLE = (HKEY)PyLong_AsVoidPtr(ob);
593 if (PyErr_Occurred())
594 return FALSE;
Guido van Rossum9f3712c2000-03-28 20:37:15 +0000595 }
596 else {
597 PyErr_SetString(
598 PyExc_TypeError,
599 "The object is not a PyHKEY object");
600 return FALSE;
601 }
602 return TRUE;
603}
604
605PyObject *
606PyHKEY_FromHKEY(HKEY h)
607{
Guido van Rossumb18618d2000-05-03 23:44:39 +0000608 PyHKEYObject *op;
609
610 /* PyObject_New is inlined */
611 op = (PyHKEYObject *) PyObject_MALLOC(sizeof(PyHKEYObject));
Guido van Rossum9f3712c2000-03-28 20:37:15 +0000612 if (op == NULL)
613 return PyErr_NoMemory();
Guido van Rossumb18618d2000-05-03 23:44:39 +0000614 PyObject_INIT(op, &PyHKEY_Type);
Guido van Rossum9f3712c2000-03-28 20:37:15 +0000615 op->hkey = h;
Guido van Rossum9f3712c2000-03-28 20:37:15 +0000616 return (PyObject *)op;
617}
618
619
620/************************************************************************
621 The module methods
622************************************************************************/
623BOOL
624PyWinObject_CloseHKEY(PyObject *obHandle)
625{
626 BOOL ok;
627 if (PyHKEY_Check(obHandle)) {
628 ok = PyHKEY_Close(obHandle);
629 }
Fred Drake25e17262000-06-30 17:48:51 +0000630#if SIZEOF_LONG >= SIZEOF_HKEY
Guido van Rossum9f3712c2000-03-28 20:37:15 +0000631 else if (PyInt_Check(obHandle)) {
632 long rc = RegCloseKey((HKEY)PyInt_AsLong(obHandle));
633 ok = (rc == ERROR_SUCCESS);
634 if (!ok)
635 PyErr_SetFromWindowsErrWithFunction(rc, "RegCloseKey");
636 }
Fred Drake25e17262000-06-30 17:48:51 +0000637#else
638 else if (PyLong_Check(obHandle)) {
639 long rc = RegCloseKey((HKEY)PyLong_AsVoidPtr(obHandle));
640 ok = (rc == ERROR_SUCCESS);
641 if (!ok)
642 PyErr_SetFromWindowsErrWithFunction(rc, "RegCloseKey");
643 }
644#endif
Guido van Rossum9f3712c2000-03-28 20:37:15 +0000645 else {
646 PyErr_SetString(
647 PyExc_TypeError,
648 "A handle must be a HKEY object or an integer");
649 return FALSE;
650 }
651 return ok;
652}
653
654
655/*
656 Private Helper functions for the registry interfaces
657
658** Note that fixupMultiSZ and countString have both had changes
659** made to support "incorrect strings". The registry specification
660** calls for strings to be terminated with 2 null bytes. It seems
Thomas Wouters7e474022000-07-16 12:04:32 +0000661** some commercial packages install strings which dont conform,
Guido van Rossum9f3712c2000-03-28 20:37:15 +0000662** causing this code to fail - however, "regedit" etc still work
663** with these strings (ie only we dont!).
664*/
665static void
666fixupMultiSZ(char **str, char *data, int len)
667{
668 char *P;
669 int i;
670 char *Q;
671
672 Q = data + len;
673 for (P = data, i = 0; P < Q && *P != '\0'; P++, i++) {
674 str[i] = P;
675 for(; *P != '\0'; P++)
676 ;
677 }
678}
679
680static int
681countStrings(char *data, int len)
682{
683 int strings;
684 char *P;
685 char *Q = data + len;
686
687 for (P = data, strings = 0; P < Q && *P != '\0'; P++, strings++)
688 for (; P < Q && *P != '\0'; P++)
689 ;
690 return strings;
691}
692
693/* Convert PyObject into Registry data.
694 Allocates space as needed. */
695static BOOL
696Py2Reg(PyObject *value, DWORD typ, BYTE **retDataBuf, DWORD *retDataSize)
697{
698 int i,j;
699 switch (typ) {
700 case REG_DWORD:
701 if (value != Py_None && !PyInt_Check(value))
702 return FALSE;
703 *retDataBuf = (BYTE *)PyMem_NEW(DWORD, sizeof(DWORD));
704 if (*retDataBuf==NULL){
705 PyErr_NoMemory();
706 return FALSE;
707 }
708 *retDataSize = sizeof(DWORD);
709 if (value == Py_None) {
710 DWORD zero = 0;
711 memcpy(*retDataBuf, &zero, sizeof(DWORD));
712 }
713 else
714 memcpy(*retDataBuf,
715 &PyInt_AS_LONG((PyIntObject *)value),
716 sizeof(DWORD));
717 break;
718 case REG_SZ:
719 case REG_EXPAND_SZ:
720 {
721 int need_decref = 0;
722 if (value == Py_None)
723 *retDataSize = 1;
724 else {
725 if (PyUnicode_Check(value)) {
726 value = PyUnicode_AsEncodedString(
727 value,
728 "mbcs",
729 NULL);
730 if (value==NULL)
731 return FALSE;
732 need_decref = 1;
733 }
734 if (!PyString_Check(value))
735 return FALSE;
736 *retDataSize = 1 + strlen(
737 PyString_AS_STRING(
738 (PyStringObject *)value));
739 }
740 *retDataBuf = (BYTE *)PyMem_NEW(DWORD, *retDataSize);
741 if (*retDataBuf==NULL){
742 PyErr_NoMemory();
743 return FALSE;
744 }
745 if (value == Py_None)
746 strcpy((char *)*retDataBuf, "");
747 else
748 strcpy((char *)*retDataBuf,
749 PyString_AS_STRING(
750 (PyStringObject *)value));
751 if (need_decref)
752 Py_DECREF(value);
753 break;
754 }
755 case REG_MULTI_SZ:
756 {
757 DWORD size = 0;
758 char *P;
759 PyObject **obs = NULL;
760
761 if (value == Py_None)
762 i = 0;
763 else {
764 if (!PyList_Check(value))
765 return FALSE;
766 i = PyList_Size(value);
767 }
768 obs = malloc(sizeof(PyObject *) * i);
769 memset(obs, 0, sizeof(PyObject *) * i);
770 for (j = 0; j < i; j++)
771 {
772 PyObject *t;
773 t = PyList_GET_ITEM(
774 (PyListObject *)value,j);
775 if (PyString_Check(t)) {
776 obs[j] = t;
777 Py_INCREF(t);
778 } else if (PyUnicode_Check(t)) {
779 obs[j] = PyUnicode_AsEncodedString(
780 t,
781 "mbcs",
782 NULL);
783 if (obs[j]==NULL)
784 goto reg_multi_fail;
785 } else
786 goto reg_multi_fail;
787 size += 1 + strlen(
788 PyString_AS_STRING(
789 (PyStringObject *)obs[j]));
790 }
791
792 *retDataSize = size + 1;
793 *retDataBuf = (BYTE *)PyMem_NEW(char,
794 *retDataSize);
795 if (*retDataBuf==NULL){
796 PyErr_NoMemory();
797 goto reg_multi_fail;
798 }
799 P = (char *)*retDataBuf;
800
801 for (j = 0; j < i; j++)
802 {
803 PyObject *t;
804 t = obs[j];
805 strcpy(P,
806 PyString_AS_STRING(
807 (PyStringObject *)t));
808 P += 1 + strlen(
809 PyString_AS_STRING(
810 (PyStringObject *)t));
811 Py_DECREF(obs[j]);
812 }
813 /* And doubly-terminate the list... */
814 *P = '\0';
815 free(obs);
816 break;
817 reg_multi_fail:
818 if (obs) {
819 for (j = 0; j < i; j++)
820 Py_XDECREF(obs[j]);
821
822 free(obs);
823 }
824 return FALSE;
825 }
826 case REG_BINARY:
827 /* ALSO handle ALL unknown data types here. Even if we can't
828 support it natively, we should handle the bits. */
829 default:
830 if (value == Py_None)
831 *retDataSize = 0;
832 else {
Mark Hammond4e80bb52000-07-28 03:44:41 +0000833 void *src_buf;
834 PyBufferProcs *pb = value->ob_type->tp_as_buffer;
835 if (pb==NULL) {
836 PyErr_Format(PyExc_TypeError,
837 "Objects of type '%s' can not "
838 "be used as binary registry values",
839 value->ob_type->tp_name);
840 return FALSE;
841 }
842 *retDataSize = (*pb->bf_getreadbuffer)(value, 0, &src_buf);
Guido van Rossum9f3712c2000-03-28 20:37:15 +0000843 *retDataBuf = (BYTE *)PyMem_NEW(char,
844 *retDataSize);
845 if (*retDataBuf==NULL){
846 PyErr_NoMemory();
847 return FALSE;
848 }
Mark Hammond4e80bb52000-07-28 03:44:41 +0000849 memcpy(*retDataBuf, src_buf, *retDataSize);
Guido van Rossum9f3712c2000-03-28 20:37:15 +0000850 }
851 break;
852 }
853 return TRUE;
854}
855
856/* Convert Registry data into PyObject*/
857static PyObject *
858Reg2Py(char *retDataBuf, DWORD retDataSize, DWORD typ)
859{
860 PyObject *obData;
861
862 switch (typ) {
863 case REG_DWORD:
864 if (retDataSize == 0)
865 obData = Py_BuildValue("i", 0);
866 else
867 obData = Py_BuildValue("i",
868 *(int *)retDataBuf);
869 break;
870 case REG_SZ:
871 case REG_EXPAND_SZ:
872 /* retDataBuf may or may not have a trailing NULL in
873 the buffer. */
874 if (retDataSize && retDataBuf[retDataSize-1] == '\0')
875 --retDataSize;
876 if (retDataSize ==0)
877 retDataBuf = "";
878 obData = PyUnicode_DecodeMBCS(retDataBuf,
879 retDataSize,
880 NULL);
881 break;
882 case REG_MULTI_SZ:
883 if (retDataSize == 0)
884 obData = PyList_New(0);
885 else
886 {
887 int index = 0;
888 int s = countStrings(retDataBuf, retDataSize);
889 char **str = (char **)malloc(sizeof(char *)*s);
890 if (str == NULL)
891 return PyErr_NoMemory();
892
893 fixupMultiSZ(str, retDataBuf, retDataSize);
894 obData = PyList_New(s);
Fred Drake25e17262000-06-30 17:48:51 +0000895 if (obData == NULL)
896 return NULL;
Guido van Rossum9f3712c2000-03-28 20:37:15 +0000897 for (index = 0; index < s; index++)
898 {
Fred Drake25e17262000-06-30 17:48:51 +0000899 size_t len = _mbstrlen(str[index]);
900 if (len > INT_MAX) {
901 PyErr_SetString(PyExc_OverflowError,
902 "registry string is too long for a Python string");
903 Py_DECREF(obData);
904 return NULL;
905 }
Guido van Rossum9f3712c2000-03-28 20:37:15 +0000906 PyList_SetItem(obData,
907 index,
908 PyUnicode_DecodeMBCS(
909 (const char *)str[index],
Fred Drake25e17262000-06-30 17:48:51 +0000910 (int)len,
Guido van Rossum9f3712c2000-03-28 20:37:15 +0000911 NULL)
912 );
913 }
914 free(str);
915
916 break;
917 }
918 case REG_BINARY:
919 /* ALSO handle ALL unknown data types here. Even if we can't
920 support it natively, we should handle the bits. */
921 default:
922 if (retDataSize == 0) {
923 Py_INCREF(Py_None);
924 obData = Py_None;
925 }
926 else
927 obData = Py_BuildValue("s#",
928 (char *)retDataBuf,
929 retDataSize);
930 break;
931 }
932 if (obData == NULL)
933 return NULL;
934 else
935 return obData;
936}
937
938/* The Python methods */
939
940static PyObject *
941PyCloseKey(PyObject *self, PyObject *args)
942{
943 PyObject *obKey;
944 if (!PyArg_ParseTuple(args, "O:CloseKey", &obKey))
945 return NULL;
946 if (!PyHKEY_Close(obKey))
947 return NULL;
948 Py_INCREF(Py_None);
949 return Py_None;
950}
951
952static PyObject *
953PyConnectRegistry(PyObject *self, PyObject *args)
954{
955 HKEY hKey;
956 PyObject *obKey;
957 char *szCompName = NULL;
958 HKEY retKey;
959 long rc;
960 if (!PyArg_ParseTuple(args, "zO:ConnectRegistry", &szCompName, &obKey))
961 return NULL;
962 if (!PyHKEY_AsHKEY(obKey, &hKey, FALSE))
963 return NULL;
964 rc = RegConnectRegistry(szCompName, hKey, &retKey);
965 if (rc != ERROR_SUCCESS)
966 return PyErr_SetFromWindowsErrWithFunction(rc,
967 "ConnectRegistry");
968 return PyHKEY_FromHKEY(retKey);
969}
970
971static PyObject *
972PyCreateKey(PyObject *self, PyObject *args)
973{
974 HKEY hKey;
975 PyObject *obKey;
976 char *subKey;
977 HKEY retKey;
978 long rc;
979 if (!PyArg_ParseTuple(args, "Oz:CreateKey", &obKey, &subKey))
980 return NULL;
981 if (!PyHKEY_AsHKEY(obKey, &hKey, FALSE))
982 return NULL;
983 rc = RegCreateKey(hKey, subKey, &retKey);
984 if (rc != ERROR_SUCCESS)
985 return PyErr_SetFromWindowsErrWithFunction(rc, "CreateKey");
986 return PyHKEY_FromHKEY(retKey);
987}
988
989static PyObject *
990PyDeleteKey(PyObject *self, PyObject *args)
991{
992 HKEY hKey;
993 PyObject *obKey;
994 char *subKey;
995 long rc;
996 if (!PyArg_ParseTuple(args, "Os:DeleteKey", &obKey, &subKey))
997 return NULL;
998 if (!PyHKEY_AsHKEY(obKey, &hKey, FALSE))
999 return NULL;
1000 rc = RegDeleteKey(hKey, subKey );
1001 if (rc != ERROR_SUCCESS)
1002 return PyErr_SetFromWindowsErrWithFunction(rc, "RegDeleteKey");
1003 Py_INCREF(Py_None);
1004 return Py_None;
1005}
1006
1007static PyObject *
1008PyDeleteValue(PyObject *self, PyObject *args)
1009{
1010 HKEY hKey;
1011 PyObject *obKey;
1012 char *subKey;
1013 long rc;
1014 if (!PyArg_ParseTuple(args, "Oz:DeleteValue", &obKey, &subKey))
1015 return NULL;
1016 if (!PyHKEY_AsHKEY(obKey, &hKey, FALSE))
1017 return NULL;
1018 Py_BEGIN_ALLOW_THREADS
1019 rc = RegDeleteValue(hKey, subKey);
1020 Py_END_ALLOW_THREADS
1021 if (rc !=ERROR_SUCCESS)
1022 return PyErr_SetFromWindowsErrWithFunction(rc,
1023 "RegDeleteValue");
1024 Py_INCREF(Py_None);
1025 return Py_None;
1026}
1027
1028static PyObject *
1029PyEnumKey(PyObject *self, PyObject *args)
1030{
1031 HKEY hKey;
1032 PyObject *obKey;
1033 int index;
1034 long rc;
1035 char *retBuf;
1036 DWORD len;
1037
1038 if (!PyArg_ParseTuple(args, "Oi:EnumKey", &obKey, &index))
1039 return NULL;
1040 if (!PyHKEY_AsHKEY(obKey, &hKey, FALSE))
1041 return NULL;
1042
1043 if ((rc = RegQueryInfoKey(hKey, NULL, NULL, NULL, NULL, &len,
1044 NULL, NULL, NULL, NULL, NULL, NULL))
1045 != ERROR_SUCCESS)
1046 return PyErr_SetFromWindowsErrWithFunction(rc,
1047 "RegQueryInfoKey");
1048 ++len; /* include null terminator */
1049 retBuf = (char *)alloca(len);
1050
1051 if ((rc = RegEnumKey(hKey, index, retBuf, len)) != ERROR_SUCCESS)
1052 return PyErr_SetFromWindowsErrWithFunction(rc, "RegEnumKey");
1053 return Py_BuildValue("s", retBuf);
1054}
1055
1056static PyObject *
1057PyEnumValue(PyObject *self, PyObject *args)
1058{
1059 HKEY hKey;
1060 PyObject *obKey;
1061 int index;
1062 long rc;
1063 char *retValueBuf;
1064 char *retDataBuf;
1065 DWORD retValueSize;
1066 DWORD retDataSize;
1067 DWORD typ;
1068 PyObject *obData;
1069 PyObject *retVal;
1070
1071 if (!PyArg_ParseTuple(args, "Oi:EnumValue", &obKey, &index))
1072 return NULL;
1073 if (!PyHKEY_AsHKEY(obKey, &hKey, FALSE))
1074 return NULL;
1075
1076 if ((rc = RegQueryInfoKey(hKey, NULL, NULL, NULL, NULL, NULL, NULL,
1077 NULL,
1078 &retValueSize, &retDataSize, NULL, NULL))
1079 != ERROR_SUCCESS)
1080 return PyErr_SetFromWindowsErrWithFunction(rc,
1081 "RegQueryInfoKey");
1082 ++retValueSize; /* include null terminators */
1083 ++retDataSize;
1084 retValueBuf = (char *)alloca(retValueSize);
1085 retDataBuf = (char *)alloca(retDataSize);
1086
1087 Py_BEGIN_ALLOW_THREADS
1088 rc = RegEnumValue(hKey,
1089 index,
1090 retValueBuf,
1091 &retValueSize,
1092 NULL,
1093 &typ,
1094 (BYTE *)retDataBuf,
1095 &retDataSize);
1096 Py_END_ALLOW_THREADS
1097
1098 if (rc != ERROR_SUCCESS)
1099 return PyErr_SetFromWindowsErrWithFunction(rc,
1100 "PyRegEnumValue");
1101 obData = Reg2Py(retDataBuf, retDataSize, typ);
1102 if (obData == NULL)
1103 return NULL;
1104 retVal = Py_BuildValue("sOi", retValueBuf, obData, typ);
1105 Py_DECREF(obData);
1106 return retVal;
1107}
1108
1109static PyObject *
1110PyFlushKey(PyObject *self, PyObject *args)
1111{
1112 HKEY hKey;
1113 PyObject *obKey;
1114 long rc;
1115 if (!PyArg_ParseTuple(args, "O:FlushKey", &obKey))
1116 return NULL;
1117 if (!PyHKEY_AsHKEY(obKey, &hKey, FALSE))
1118 return NULL;
1119 Py_BEGIN_ALLOW_THREADS
1120 rc = RegFlushKey(hKey);
1121 Py_END_ALLOW_THREADS
1122 if (rc != ERROR_SUCCESS)
1123 return PyErr_SetFromWindowsErrWithFunction(rc, "RegFlushKey");
1124 Py_INCREF(Py_None);
1125 return Py_None;
1126}
1127static PyObject *
1128PyLoadKey(PyObject *self, PyObject *args)
1129{
1130 HKEY hKey;
1131 PyObject *obKey;
1132 char *subKey;
1133 char *fileName;
1134
1135 long rc;
1136 if (!PyArg_ParseTuple(args, "Oss:LoadKey", &obKey, &subKey, &fileName))
1137 return NULL;
1138 if (!PyHKEY_AsHKEY(obKey, &hKey, FALSE))
1139 return NULL;
1140 Py_BEGIN_ALLOW_THREADS
1141 rc = RegLoadKey(hKey, subKey, fileName );
1142 Py_END_ALLOW_THREADS
1143 if (rc != ERROR_SUCCESS)
1144 return PyErr_SetFromWindowsErrWithFunction(rc, "RegLoadKey");
1145 Py_INCREF(Py_None);
1146 return Py_None;
1147}
1148
1149static PyObject *
1150PyOpenKey(PyObject *self, PyObject *args)
1151{
1152 HKEY hKey;
1153 PyObject *obKey;
1154
1155 char *subKey;
1156 int res = 0;
1157 HKEY retKey;
1158 long rc;
1159 REGSAM sam = KEY_READ;
1160 if (!PyArg_ParseTuple(args, "Oz|ii:OpenKey", &obKey, &subKey,
1161 &res, &sam))
1162 return NULL;
1163 if (!PyHKEY_AsHKEY(obKey, &hKey, FALSE))
1164 return NULL;
1165
1166 Py_BEGIN_ALLOW_THREADS
1167 rc = RegOpenKeyEx(hKey, subKey, res, sam, &retKey);
1168 Py_END_ALLOW_THREADS
1169 if (rc != ERROR_SUCCESS)
1170 return PyErr_SetFromWindowsErrWithFunction(rc, "RegOpenKeyEx");
1171 return PyHKEY_FromHKEY(retKey);
1172}
1173
1174
1175static PyObject *
1176PyQueryInfoKey(PyObject *self, PyObject *args)
1177{
1178 HKEY hKey;
1179 PyObject *obKey;
1180 long rc;
1181 DWORD nSubKeys, nValues;
1182 FILETIME ft;
1183 LARGE_INTEGER li;
1184 PyObject *l;
1185 PyObject *ret;
1186 if (!PyArg_ParseTuple(args, "O:QueryInfoKey", &obKey))
1187 return NULL;
1188 if (!PyHKEY_AsHKEY(obKey, &hKey, FALSE))
1189 return NULL;
1190 if ((rc = RegQueryInfoKey(hKey, NULL, NULL, 0, &nSubKeys, NULL, NULL,
1191 &nValues, NULL, NULL, NULL, &ft))
1192 != ERROR_SUCCESS)
1193 return PyErr_SetFromWindowsErrWithFunction(rc, "RegQueryInfoKey");
1194 li.LowPart = ft.dwLowDateTime;
1195 li.HighPart = ft.dwHighDateTime;
1196 l = PyLong_FromLongLong(li.QuadPart);
1197 if (l == NULL)
1198 return NULL;
1199 ret = Py_BuildValue("iiO", nSubKeys, nValues, l);
1200 Py_DECREF(l);
1201 return ret;
1202}
1203
1204static PyObject *
1205PyQueryValue(PyObject *self, PyObject *args)
1206{
1207 HKEY hKey;
1208 PyObject *obKey;
1209 char *subKey;
1210
1211 long rc;
1212 char *retBuf;
1213 long bufSize = 0;
1214 if (!PyArg_ParseTuple(args, "Oz:QueryValue", &obKey, &subKey))
1215 return NULL;
1216
1217 if (!PyHKEY_AsHKEY(obKey, &hKey, FALSE))
1218 return NULL;
1219 if ((rc = RegQueryValue(hKey, subKey, NULL, &bufSize))
1220 != ERROR_SUCCESS)
1221 return PyErr_SetFromWindowsErrWithFunction(rc,
1222 "RegQueryValue");
1223 retBuf = (char *)alloca(bufSize);
1224 if ((rc = RegQueryValue(hKey, subKey, retBuf, &bufSize))
1225 != ERROR_SUCCESS)
1226 return PyErr_SetFromWindowsErrWithFunction(rc,
1227 "RegQueryValue");
1228 return Py_BuildValue("s", retBuf);
1229}
1230
1231static PyObject *
1232PyQueryValueEx(PyObject *self, PyObject *args)
1233{
1234 HKEY hKey;
1235 PyObject *obKey;
1236 char *valueName;
1237
1238 long rc;
1239 char *retBuf;
1240 DWORD bufSize = 0;
1241 DWORD typ;
1242 PyObject *obData;
1243 PyObject *result;
1244
1245 if (!PyArg_ParseTuple(args, "Oz:QueryValueEx", &obKey, &valueName))
1246 return NULL;
1247
1248 if (!PyHKEY_AsHKEY(obKey, &hKey, FALSE))
1249 return NULL;
1250 if ((rc = RegQueryValueEx(hKey, valueName,
1251 NULL, NULL, NULL,
1252 &bufSize))
1253 != ERROR_SUCCESS)
1254 return PyErr_SetFromWindowsErrWithFunction(rc,
1255 "RegQueryValueEx");
1256 retBuf = (char *)alloca(bufSize);
1257 if ((rc = RegQueryValueEx(hKey, valueName, NULL,
1258 &typ, (BYTE *)retBuf, &bufSize))
1259 != ERROR_SUCCESS)
1260 return PyErr_SetFromWindowsErrWithFunction(rc,
1261 "RegQueryValueEx");
1262 obData = Reg2Py(retBuf, bufSize, typ);
1263 if (obData == NULL)
1264 return NULL;
1265 result = Py_BuildValue("Oi", obData, typ);
1266 Py_DECREF(obData);
1267 return result;
1268}
1269
1270
1271static PyObject *
1272PySaveKey(PyObject *self, PyObject *args)
1273{
1274 HKEY hKey;
1275 PyObject *obKey;
1276 char *fileName;
1277 LPSECURITY_ATTRIBUTES pSA = NULL;
1278
1279 long rc;
1280 if (!PyArg_ParseTuple(args, "Os:SaveKey", &obKey, &fileName))
1281 return NULL;
1282 if (!PyHKEY_AsHKEY(obKey, &hKey, FALSE))
1283 return NULL;
1284/* One day we may get security into the core?
1285 if (!PyWinObject_AsSECURITY_ATTRIBUTES(obSA, &pSA, TRUE))
1286 return NULL;
1287*/
1288 Py_BEGIN_ALLOW_THREADS
1289 rc = RegSaveKey(hKey, fileName, pSA );
1290 Py_END_ALLOW_THREADS
1291 if (rc != ERROR_SUCCESS)
1292 return PyErr_SetFromWindowsErrWithFunction(rc, "RegSaveKey");
1293 Py_INCREF(Py_None);
1294 return Py_None;
1295}
1296
1297static PyObject *
1298PySetValue(PyObject *self, PyObject *args)
1299{
1300 HKEY hKey;
1301 PyObject *obKey;
1302 char *subKey;
1303 char *str;
1304 DWORD typ;
1305 DWORD len;
1306 long rc;
1307 PyObject *obStrVal;
1308 PyObject *obSubKey;
1309 if (!PyArg_ParseTuple(args, "OOiO:SetValue",
1310 &obKey,
1311 &obSubKey,
1312 &typ,
1313 &obStrVal))
1314 return NULL;
1315 if (!PyHKEY_AsHKEY(obKey, &hKey, FALSE))
1316 return NULL;
1317 if (typ != REG_SZ) {
1318 PyErr_SetString(PyExc_TypeError,
1319 "Type must be win32con.REG_SZ");
1320 return NULL;
1321 }
1322 /* XXX - need Unicode support */
1323 str = PyString_AsString(obStrVal);
1324 if (str == NULL)
1325 return NULL;
1326 len = PyString_Size(obStrVal);
1327 if (obSubKey == Py_None)
1328 subKey = NULL;
1329 else {
1330 subKey = PyString_AsString(obSubKey);
1331 if (subKey == NULL)
1332 return NULL;
1333 }
1334 Py_BEGIN_ALLOW_THREADS
1335 rc = RegSetValue(hKey, subKey, REG_SZ, str, len+1);
1336 Py_END_ALLOW_THREADS
1337 if (rc != ERROR_SUCCESS)
1338 return PyErr_SetFromWindowsErrWithFunction(rc, "RegSetValue");
1339 Py_INCREF(Py_None);
1340 return Py_None;
1341}
1342
1343static PyObject *
1344PySetValueEx(PyObject *self, PyObject *args)
1345{
1346 HKEY hKey;
1347 PyObject *obKey;
1348 char *valueName;
1349 PyObject *obRes;
1350 PyObject *value;
1351 BYTE *data;
1352 DWORD len;
1353 DWORD typ;
1354
1355 LONG rc;
1356
1357 if (!PyArg_ParseTuple(args, "OzOiO:SetValueEx",
1358 &obKey,
1359 &valueName,
1360 &obRes,
1361 &typ,
1362 &value))
1363 return NULL;
1364 if (!PyHKEY_AsHKEY(obKey, &hKey, FALSE))
1365 return NULL;
1366 if (!Py2Reg(value, typ, &data, &len))
1367 {
1368 if (!PyErr_Occurred())
1369 PyErr_SetString(PyExc_ValueError,
1370 "Could not convert the data to the specified type.");
1371 return NULL;
1372 }
1373 Py_BEGIN_ALLOW_THREADS
1374 rc = RegSetValueEx(hKey, valueName, 0, typ, data, len);
1375 Py_END_ALLOW_THREADS
Guido van Rossumb18618d2000-05-03 23:44:39 +00001376 PyMem_DEL(data);
Guido van Rossum9f3712c2000-03-28 20:37:15 +00001377 if (rc != ERROR_SUCCESS)
1378 return PyErr_SetFromWindowsErrWithFunction(rc,
1379 "RegSetValueEx");
1380 Py_INCREF(Py_None);
1381 return Py_None;
1382}
1383
1384static struct PyMethodDef winreg_methods[] = {
Neal Norwitz031829d2002-03-31 14:37:44 +00001385 {"CloseKey", PyCloseKey, METH_VARARGS, CloseKey_doc},
1386 {"ConnectRegistry", PyConnectRegistry, METH_VARARGS, ConnectRegistry_doc},
1387 {"CreateKey", PyCreateKey, METH_VARARGS, CreateKey_doc},
1388 {"DeleteKey", PyDeleteKey, METH_VARARGS, DeleteKey_doc},
1389 {"DeleteValue", PyDeleteValue, METH_VARARGS, DeleteValue_doc},
1390 {"EnumKey", PyEnumKey, METH_VARARGS, EnumKey_doc},
1391 {"EnumValue", PyEnumValue, METH_VARARGS, EnumValue_doc},
1392 {"FlushKey", PyFlushKey, METH_VARARGS, FlushKey_doc},
1393 {"LoadKey", PyLoadKey, METH_VARARGS, LoadKey_doc},
1394 {"OpenKey", PyOpenKey, METH_VARARGS, OpenKey_doc},
1395 {"OpenKeyEx", PyOpenKey, METH_VARARGS, OpenKeyEx_doc},
1396 {"QueryValue", PyQueryValue, METH_VARARGS, QueryValue_doc},
1397 {"QueryValueEx", PyQueryValueEx, METH_VARARGS, QueryValueEx_doc},
1398 {"QueryInfoKey", PyQueryInfoKey, METH_VARARGS, QueryInfoKey_doc},
1399 {"SaveKey", PySaveKey, METH_VARARGS, SaveKey_doc},
1400 {"SetValue", PySetValue, METH_VARARGS, SetValue_doc},
1401 {"SetValueEx", PySetValueEx, METH_VARARGS, SetValueEx_doc},
Guido van Rossum9f3712c2000-03-28 20:37:15 +00001402 NULL,
1403};
1404
1405static void
1406insint(PyObject * d, char * name, long value)
1407{
1408 PyObject *v = PyInt_FromLong(value);
1409 if (!v || PyDict_SetItemString(d, name, v))
1410 PyErr_Clear();
1411 Py_XDECREF(v);
1412}
1413
1414#define ADD_INT(val) insint(d, #val, val)
1415
1416static void
1417inskey(PyObject * d, char * name, HKEY key)
1418{
1419 PyObject *v = PyLong_FromVoidPtr(key);
1420 if (!v || PyDict_SetItemString(d, name, v))
1421 PyErr_Clear();
1422 Py_XDECREF(v);
1423}
1424
1425#define ADD_KEY(val) inskey(d, #val, val)
1426
Fred Drake270e19b2000-06-29 16:14:14 +00001427__declspec(dllexport) void init_winreg(void)
Guido van Rossum9f3712c2000-03-28 20:37:15 +00001428{
1429 PyObject *m, *d;
Fred Drake270e19b2000-06-29 16:14:14 +00001430 m = Py_InitModule3("_winreg", winreg_methods, module_doc);
Guido van Rossum9f3712c2000-03-28 20:37:15 +00001431 d = PyModule_GetDict(m);
1432 PyHKEY_Type.ob_type = &PyType_Type;
1433 PyHKEY_Type.tp_doc = PyHKEY_doc;
1434 Py_INCREF(&PyHKEY_Type);
1435 if (PyDict_SetItemString(d, "HKEYType",
1436 (PyObject *)&PyHKEY_Type) != 0)
1437 return;
1438 Py_INCREF(PyExc_WindowsError);
1439 if (PyDict_SetItemString(d, "error",
1440 PyExc_WindowsError) != 0)
1441 return;
1442
1443 /* Add the relevant constants */
1444 ADD_KEY(HKEY_CLASSES_ROOT);
1445 ADD_KEY(HKEY_CURRENT_USER);
1446 ADD_KEY(HKEY_LOCAL_MACHINE);
1447 ADD_KEY(HKEY_USERS);
1448 ADD_KEY(HKEY_PERFORMANCE_DATA);
1449#ifdef HKEY_CURRENT_CONFIG
1450 ADD_KEY(HKEY_CURRENT_CONFIG);
1451#endif
1452#ifdef HKEY_DYN_DATA
1453 ADD_KEY(HKEY_DYN_DATA);
1454#endif
1455 ADD_INT(KEY_QUERY_VALUE);
1456 ADD_INT(KEY_SET_VALUE);
1457 ADD_INT(KEY_CREATE_SUB_KEY);
1458 ADD_INT(KEY_ENUMERATE_SUB_KEYS);
1459 ADD_INT(KEY_NOTIFY);
1460 ADD_INT(KEY_CREATE_LINK);
1461 ADD_INT(KEY_READ);
1462 ADD_INT(KEY_WRITE);
1463 ADD_INT(KEY_EXECUTE);
1464 ADD_INT(KEY_ALL_ACCESS);
1465 ADD_INT(REG_OPTION_RESERVED);
1466 ADD_INT(REG_OPTION_NON_VOLATILE);
1467 ADD_INT(REG_OPTION_VOLATILE);
1468 ADD_INT(REG_OPTION_CREATE_LINK);
1469 ADD_INT(REG_OPTION_BACKUP_RESTORE);
1470 ADD_INT(REG_OPTION_OPEN_LINK);
1471 ADD_INT(REG_LEGAL_OPTION);
1472 ADD_INT(REG_CREATED_NEW_KEY);
1473 ADD_INT(REG_OPENED_EXISTING_KEY);
1474 ADD_INT(REG_WHOLE_HIVE_VOLATILE);
1475 ADD_INT(REG_REFRESH_HIVE);
1476 ADD_INT(REG_NO_LAZY_FLUSH);
1477 ADD_INT(REG_NOTIFY_CHANGE_NAME);
1478 ADD_INT(REG_NOTIFY_CHANGE_ATTRIBUTES);
1479 ADD_INT(REG_NOTIFY_CHANGE_LAST_SET);
1480 ADD_INT(REG_NOTIFY_CHANGE_SECURITY);
1481 ADD_INT(REG_LEGAL_CHANGE_FILTER);
1482 ADD_INT(REG_NONE);
1483 ADD_INT(REG_SZ);
1484 ADD_INT(REG_EXPAND_SZ);
1485 ADD_INT(REG_BINARY);
1486 ADD_INT(REG_DWORD);
1487 ADD_INT(REG_DWORD_LITTLE_ENDIAN);
1488 ADD_INT(REG_DWORD_BIG_ENDIAN);
1489 ADD_INT(REG_LINK);
1490 ADD_INT(REG_MULTI_SZ);
1491 ADD_INT(REG_RESOURCE_LIST);
1492 ADD_INT(REG_FULL_RESOURCE_DESCRIPTOR);
1493 ADD_INT(REG_RESOURCE_REQUIREMENTS_LIST);
1494}
1495