CRegKey::QueryStringValue

项目
02/21/2013

调用此方法检索字符串数据为指定值名称。

LONG QueryStringValue(
   LPCTSTR pszValueName,
   LPTSTR pszValue,
   ULONG* pnChars 
) throw( );

参数

pszValueName
对包含值的名称一个Null结尾的字符串的指针查询。
pszValue
用于接收字符串数据的缓冲区的指针。
pnChars
该范围中，TCHARs，缓冲区指向由 pszValue。当方法返回时，pnChars 在TCHARs，该字符串包含该范围，检索，包括一个null字符）。

返回值

如果方法成功，ERROR_SUCCESS返回。如果方法无法读取值，则返回在WINERROR.H.定义的一个非零错误代码。如果引用的数据不是类型为REG_SZ，ERROR_INVALID_DATA返回。如果此方法返回ERROR_MORE_DATA，pnChars 等于零，而不是必需的缓冲区大小(以字节为单位）。

备注

此方法使用 RegQueryValueEx 并确认正确的数据类型返回。有关详细信息 RegQueryValueEx 参见。

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