CRegKey::QueryStringValue

Článek
06/09/2015

Tato metoda načítání dat řetězce pro zadanou hodnotu názvu volání.

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

Parametry

pszValueName
Ukazatel na řetězec zakončený obsahující název hodnoty dotazu.
pszValue
Ukazatel do vyrovnávací paměti, který přijímá data řetězec.
pnChars
Velikost v TCHARs vyrovnávací paměti odkazuje pszValue .Pokud metoda vrátí, pnChars obsahuje velikost v TCHARs řetězce načteny, včetně ukončujícím znakem null.

Vrácená hodnota

Pokud metoda uspěje, je vrácena ERROR_SUCCESS.Jestliže metoda čtení hodnotu, vrátí kód chyby nenulové, definovaný v WINERROR.H.Pokud není odkazováno data typu REG_SZ, je vrácena ERROR_INVALID_DATA.Pokud metoda vrátí hodnotu ERROR_MORE_DATA, pnChars se rovná nule, není velikost požadované vyrovnávací paměti v bajtech.

Poznámky

Tato metoda využívá RegQueryValueEx a potvrzuje, že je správný typ dat vrátil.Viz RegQueryValueEx další podrobnosti.

Poznámka k zabezpečení
Tato metoda umožňuje volajícímu zadat libovolné umístění registru potenciálně čtení dat, které nelze důvěřovat.Také RegQueryValueEx funkce používá tuto metodu výslovně nezpracovává řetězců, které jsou zakončeny znakem NULL.Obě podmínky by měly být kontrolovány volající kód.