CRegKey::QueryValue

调用此方法检索数据。m_hKey的字段指定值。 此方法的早期版本不再支持和标记为 ATL_DEPRECATED

LONG QueryValue(
   LPCTSTR pszValueName,
   DWORD* pdwType,
   void* pData,
   ULONG* pnBytes
) throw( );
ATL_DEPRECATED LONG QueryValue(
   DWORD& dwValue,
   LPCTSTR lpszValueName 
);
ATL_DEPRECATED LONG QueryValue(
   LPTSTR szValue,
   LPCTSTR lpszValueName,
   DWORD* pdwCount 
);

参数

  • pszValueName
    对包含值的名称一个Null结尾的字符串的指针查询。 如果 pszValueName 为NULL或为空字符串,"",方法检索类型和数据。未命名的键的或默认值,如果有的话)。

  • pdwType
    用于接收指示数据类型的代码的变量的指针存储了按指定值。 如果不需要,pdwType 参数可以是NULL该类型代码。

  • pData
    用于接收值的数据缓冲区的指针。 如果不需要,此参数可以为NULL该数据。

  • pnBytes
    对于字节,缓冲区指定大小,变量的指针指向由 pData 参数。 当方法返回时,该变量包含数据的大小复制到 pData。

  • dwValue
    值字段的数字数据。

  • lpszValueName
    指定将要查询的值字段。

  • szValue
    值字段的字符串数据。

  • pdwCount
    字符串数据的大小。 其值最初设置为 szValue 缓冲区的大小。

返回值

如果成功,则返回; ERROR_SUCCESS否则,在WINERROR.H.定义的一个非零错误代码。

备注

QueryValue 的两个部初始版本不再支持和标记为 ATL_DEPRECATED。 如果使用,则编译器将发出警告这些窗体。

剩余的方法调用RegQueryValueEx。

安全说明安全说明

此方法允许调用方指定任何注册表位置,可能会读取无法信任的数据。此外,使用的RegQueryValueEx函数不显式此方法是 NULL 停止的处理字符串。应检查两个条件由调用代码。

要求

Header: atlbase.h

请参见

参考

CRegKey选件类

CRegKey::SetValue

Registry Value Types