LCD驱动中的RegQueryValueEx函数--翻译自MSDN

This function retrieves the type and data for a specified value associated with an open registry key.
这个函数重新获得指定值的类型和数据。
A remote application interface (RAPI) version of this function exists called CeRegQueryValueEx (RAPI).
这个函数一个远程应用接口的版本是CeRegQueryValueEx (RAPI)。
LONG RegQueryValueEx(
  HKEY hKey,
  LPCWSTR lpValueName,
  LPDWORD lpReserved,
  LPDWORD lpType,
  LPBYTE lpData,
  LPDWORD lpcbData
);
hKey
[in] Handle to a currently open key or any of the following predefined reserved handle
输入 当前打开键值的句柄或者任何下面预定义保留的句柄
values:

HKEY_LOCAL_MACHINE


HKEY_CLASSES_ROOT


HKEY_CURRENT_USER


HKEY_USERS


lpValueName
[in] Pointer to a string containing the name of the value to query. If this parameter is set to NULL or an empty string, the function retrieves the type and data for the key's unnamed value. A registry key does not automatically have an unnamed or default value. Unnamed values can be of any type.
输入 指向一个包含要查询的值的名字的字符串。如果这个参数被设置成NULL或者空字符串，函数重新获得没有命名键值的类型或者数据。一个注册键值不能自动地获得一个未命名的或者默认的值，未命名的值可以是任何类型。
lpReserved
[in] Reserved. Set to NULL.
输入 保留 设置NULL
lpType
[out] Pointer to a variable that receives the type of data associated with the specified value. The following table shows possible values.
输出 指向一个变量，这个变量接收指定值的类型和数据。下面的表格显示了可能的值。
Value                Description  
值                   描述
REG_BINARY           Specifies binary data in any form.
REG_BINARY           指定任何格式的二进制数据
 
REG_DWORD            Specifies a 32-bit number.
REG_DWORD            指定一个32bit的数据
 
REG_DWORD_BIG_ENDIAN  Specifies a 32-bit number in big-endian format.
REG_DWORD_BIG_ENDIAN  指定一个32bit的数据，按照大端格式排列

In big-endian format, a multibyte value is stored in memory from the highest byte to the lowest byte. For example, the value 0x12345678 is stored as (0x12 0x34 0x56 0x78) in big-endian format.
在大端格式里，一个多字节的值按照从高字节到低字节的顺序被存储在内存中。例如：值0x12345678按照大端模式排列为：0x12 0x34 0x56 0x78
 
REG_DWORD_LITTLE_ENDIAN  Specifies a 32-bit number in little-endian format. This is equivalent to REG_DWORD.
REG_DWORD_LITTLE_ENDIAN  指定一个32bit数据按照小端格式进行排列。这等价于REG_DWORD。
In little-endian format, a multibyte value is stored in memory from the lowest byte to the highest byte. For example, the value 0x12345678 is stored as (0x78 0x56 0x34 0x12) in little-endian format.
在小端模式下，一个多字节按照从低到高的模式进行排列存储在内存中。例如：一个值0x12345678按照小端模式存储为0x78 0x56 0x34 0x12.

REG_EXPAND_SZ           Specifies a null-terminated string that contains unexpanded references to environment variables. For example, %PATH%.
REG_EXPAND_SZ           指定一个零值的终端字符串（a null-terminated string）包含一个非扩张参考（unexpanded references）对于一个环境变量，例如：%PATH%.
REG_LINK                Specifies a Unicode symbolic link. Used internally. Applications do not use this type.
REG_LINK                指定一个Unicode符号链接（symbolic link）。内部使用。应用程序并不是用这个类型。
REG_MULTI_SZ            Specifies an array of null-terminated strings, terminated by two null characters.
REG_MULTI_SZ            指定一个数组包含零值的终端字符串（null-terminated strings），以两个零值的字结束（ terminated by two null characters）。

REG_NONE                No defined value type.
REG_NONE                并不定义成值的类型。
 
REG_RESOURCE_LIST       Specifies a device-driver resource list.
REG_RESOURCE_LIST       指定一个设备驱动资源列表
 
REG_SZ                  Specifies a null-terminated Unicode string.
REG_SZ                  指定一个零值终端Unicode字符串（a null-terminated Unicode string）。



This parameter can be set to NULL if the type is not required.
这个参数可以被设置成NULL，如果类型没有被要求。
lpData
[out] Pointer to a buffer that receives value data. This parameter can be set to NULL if the data is not required.
输出 指向接收数据值的缓存buffer.这个参数可以被设置成NULL，如果数据没有要求。
lpcbData
[in, out] Pointer to a variable that specifies the size, in bytes, of the buffer pointed to by the lpData parameter. When the function returns, this variable contains the size of the data copied to lpData.

输入，输出 指向一个变量，这个变量明确了lpData参数指向缓存的大小，用字节表示。当函数返回的时候，这个变量包含了拷贝到lpData的数据的大小。

If the data has the REG_SZ, REG_MULTI_SZ or the REG_EXPAND_SZ type, this function checks for a terminating null character. If one is not found, the string is stored with a null terminator. This parameter also includes the size of the terminating null character.

如果数据有REG_SZ，REG_MULTI_SZ or the REG_EXPAND_SZ类型，这个函数校验终端是否有字（a terminating null character）。如果没有发现任何字（character），字符串存储在一个null得终结器里面。这个参数也包括终端null character的大小。

This parameter can be set to NULL only if lpData is set to NULL.
这个参数可以被设置成NULL，如果lpData也被设置成NULL。

If the buffer specified by lpData is not large enough to hold the data, including a null terminator for string data, the function returns ERROR_MORE_DATA and stores the required buffer size, in bytes, to the variable pointed to by this parameter.
如果lpData指定的缓存不够大来装数据，包括一个装字符串数据的null终结器（ a null terminator）。函数返回ERROR_MORE_DATA并且存储要求的缓存的大小，以字节为单位存储，按照这个参数指向的变量。

If lpData is set to NULL, and this parameter is non-NULL, the function returns ERROR_SUCCESS and stores the size of the data, in bytes, in the variable pointed to by this parameter. This enables an application to determine the best way to allocate a buffer for value data.
如果lpData被设置成NULL，并且这个参数是non-NULL，函数返回ERROR_SUCCESS ，并且存储数据的大小，以字节为单位，在这个参数指向的变量中。这将允许一个应用程序决定最好的方式给值数据分配一个缓存。

Return Value
返回值
ERROR_SUCCESS indicates success. A nonzero error code defined in Winerror.h indicates failure. To get a generic description of the error, call the FormatMessage function with the FORMAT_MESSAGE_FROM_SYSTEM flag set. The message resource is optional, so FormatMessage might fail.
ERROR_SUCCESS指示成功。一个非0的错误代码定义在Winerror.h中指示出错误。为了获得错误的通用描述，调用设置带FORMAT_MESSAGE_FROM_SYSTEM flag标志的格式化信息函数。信息资源是可以选择的，所以格式化信息可能失败。

Requirements
要求
Header winreg.h
Library coredll.lib
Windows Embedded CE Windows CE 1.0 and later