生活的天平本不平衡,只有通过努力改变其偏向。

Windows驱动编程基础教程 第七部分

2008-05-30

本文作者是楚狂人,有问题请联系QQ16191935,msn walled_river@hotmail.com

Windows驱动编程基础教程(4.2-4.3)

4.2 注册值的读

一般使用ZwQueryValueKey来读取注册表中键的值。要注意的是注册表中的值可能有多种数据类型。而且长度也是没有定数的。为此,在读取过程中,就可能要面对很多种可能的情况。ZwQueryValueKey这个函数的原型如下:

C++代码
  1. NTSTATUS ZwQueryValueKey(
  2. IN HANDLE KeyHandle,
  3. IN PUNICODE_STRING  ValueName,
  4. IN KEY_VALUE_INFORMATION_CLASS  KeyValueInformationClass,
  5. OUT PVOID KeyValueInformation,
  6. IN ULONG Length,
  7. OUT PULONG ResultLength
  8. );

KeyHandle:这是用ZwCreateKey或者ZwOpenKey所打开的一个注册表键句柄。
ValueName:要读取的值的名字。
KeyValueInformationClass:本次查询所需要查询的信息类型。这有如下的三种可能。
KeyValueBasicInformation:获得基础信息,包含值名和类型。
KeyValueFullInformation:获得完整信息。包含值名、类型和值的数据。
KeyValuePartialInformation:获得局部信息。包含类型和值数据。
很容易看出实际上名字是已知的,获得基础信息是多此一举。同样获得完整信息也是浪费内存空间。因为调用ZwQueryValueKey的目的是为了得到类 型和值数据。因此使用KeyValuePartialInformation最常见。当采用KeyValuePartialInformation的时 候,一个类型为KEY_VALUE_PARTIAL_INFORMATION的结构将被返回到参数KeyValueInformation所指向的内存 中。
KeyValueInformation:当KeyValueInformationClass被设置为 KeyValuePartialInformation时,KEY_VALUE_PARTIAL_INFORMATION结构将被返回到这个指针所指内存 中。下面是结构KEY_VALUE_PARTIAL_INFORMATION的原型。

C++代码
  1. typedef struct _KEY_VALUE_PARTIAL_INFORMATION {
  2. ULONG TitleIndex; // 请忽略这个成员
  3. ULONG Type; // 数据类型
  4. ULONG DataLength; // 数据长度
  5. UCHAR Data[1]; // 可变长度的数据
  6. }KEY_VALUE_PARTIAL_INFORMATION,*PKEY_VALUE_PARTIAL_INFORMATIO;

上面的数据类型Type有很多种可能,但是最常见的几种如下:
REG_BINARY:十六进制数据。
REG_DWORD:四字节整数。
REG_SZ:以空结束的Unicode字符串。
Length:用户传入的输出空间KeyValueInformation的长度。
ResultLength:返回实际需要的长度。
返回值:如果说实际需要的长度比Length要大,那么返回STATUS_BUFFER_OVERFLOW或者是STATUS_BUFFER_TOO_SMALL。如果成功读出了全部数据,那么返回STATUS_SUCCESS。其他的情况,返回一个错误码。
下面请读者考虑如何把上一小节的函数写完整。这其中比较常见的一个问题是在读取注册表键下的值之前,往往不知道这个值有多长。所以有些比较偷懒的程序员总 是定义一个足够的大小的空间(比如512字节)。这样的坏处是浪费内存(一般都是在堆栈中定义,而内核编程中堆栈空间被耗尽又是另一个常见的蓝屏问题)。 此外也无法避免值实际上大于该长度的情况。为此应该耐心的首先获取长度,然后不足时再动态分配内存进行读取。下面是示例代码:

C++代码
  1. // 要读取的值的名字
  2. UNICODE_STRING my_key_name =
  3. RTL_CONSTANT_STRING(L”SystemRoot”);
  4. // 用来试探大小的key_infor
  5. KEY_VALUE_PARTIAL_INFORMATION key_infor;
  6. // 最后实际用到的key_infor指针。内存分配在堆中
  7. PKEY_VALUE_PARTIAL_INFORMATION ac_key_infor;
  8. ULONG ac_length;
  9. ……
  10. // 前面已经打开了句柄my_key,下面如此来读取值:
  11. status = ZwQueryValueKey(
  12. my_key,
  13. &my_key_name,
  14. KeyValuePartialInformation,
  15. &key_infor,
  16. sizeof(KEY_VALUE_PARTIAL_INFORMATION),
  17. &ac_length);
  18. if(!NT_SUCCESS(status) &&
  19. status != STATUS_BUFFER_OVERFLOW &&
  20. status != STATUS_BUFFER_TOO_SMALL)
  21. {
  22. // 错误处理
  23. }
  24. // 如果没失败,那么分配足够的空间,再次读取
  25. ac_key_infor = (PKEY_VALUE_PARTIAL_INFORMATION)
  26. ExAllocatePoolWithTag(NonpagedPool,ac_length ,MEM_TAG);
  27. if(ac_key_infor == NULL)
  28. {
  29. stauts = STATUS_INSUFFICIENT_RESOURCES;
  30. // 错误处理
  31. }
  32. status = ZwQueryValueKey(
  33. my_key,
  34. &my_key_name,
  35. KeyValuePartialInformation,
  36. ac_key_infor,
  37. ac_length,
  38. &ac_length);
  39. // 到此为止,如果status为STATUS_SUCCESS,则要读取的数据已经
  40. // 在ac_key_infor->Data中。请利用前面学到的知识,转换为
  41. // UNICODE_STRING
  42. ……

4.3 注册值的写

实际上注册表的写入比读取要简单。因为这省略了一个尝试数据的大小的过程。直接将数据写入即可。写入值一般使用函数ZwSetValueKey 。这个函数的原型如下:

C++代码
  1. NTSTATUS ZwSetValueKey(
  2. IN HANDLE KeyHandle,
  3. IN PUNICODE_STRING  ValueName,
  4. IN ULONG TitleIndex  OPTIONAL,
  5. IN ULONG Type,
  6. IN PVOID Data,
  7. IN ULONG DataSize
  8. );

其中的TileIndex参数请始终填入0。
KeyHandle、ValueName、Type这三个参数和ZwQueryValueKey中对应的参数相同。不同的是Data和DataSize。 Data是要写入的数据的开始地址,而DataSize是要写入的数据的长度。由于Data是一个空指针,因此,Data可以指向任何数据。也就是说,不 管Type是什么,都可以在Data中填写相应的数据写入。
ZwSetValueKey的时候,并不需要该Value已经存在。如果该Value已经存在,那么其值会被这次写入覆盖。如果不存在,则会新建一个。下 面的例子写入一个名字为“Test”,而且值为“My Test Value”的字符串值。假设my_key是一个已经打开的子键的句柄。

C++代码
  1. UNICODE_STRING name = RTL_CONSTANT_STRING(L”Test”);
  2. PWCHAR value = { L”My Test Value” };
  3. // 写入数据。数据长度之所以要将字符串长度加上1,是为了把最后一个空结束符
  4. // 写入。我不确定如果不写入空结束符会不会有错,有兴趣的读者请自己测试一下。
  5. status = ZwSetValueKey(my_key,
  6. &name,0,REG_SZ,value,(wcslen(value)+1)*sizeof(WCHAR));
  7. if(!NT_SUCCESS(status))
  8. {
  9. // 错误处理
  10. ……
  11. }

关于注册表的操作就介绍到这里了。如果有进一步的需求,建议读者阅读WDK相关的文档。

作者:lonkil | 分类目录:编程开发 | 标签:

发表评论

电子邮件地址不会被公开。 必填项已用 * 标注

*

您可以使用这些 HTML 标签和属性: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>