CRegKey::QueryStringValue

Artykuł
02/27/2013

Wywołanie tej metody do pobierania danych ciąg nazwy określonej wartości.

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

Parametry

pszValueName
Wskaźnik, aby ciąg zakończony zerem zawierającego nazwę wartości do kwerendy.
pszValue
Wskaźnik do buforu, który odbiera dane ciągu.
pnChars
Rozmiar w TCHARs bufora wskazywanego przez pszValue.Gdy metoda zwraca, pnChars zawiera rozmiar w TCHARs ciągu pobierane, włączając kończącego znaku null.

Wartość zwracana

Metody zakończy się pomyślnie, zwracany jest ERROR_SUCCESS.Jeśli metoda nie może odczytać wartość, zwraca kod błędu niezerową, zdefiniowany w powiodło się.H.Dane odwołania nie jest typu REG_SZ, zwracana jest ERROR_INVALID_DATA.Jeśli metoda zwraca kod ERROR_MORE_DATA, pnChars jest równe zero, nie wymagany rozmiar buforu w bajtach.

Uwagi

Metoda ta wykorzystuje RegQueryValueEx i potwierdza, że jest zwracany poprawny typ danych.Zobacz RegQueryValueEx więcej informacji.

Uwaga dotycząca zabezpieczeń
Ta metoda umożliwia rozmówcy do określenia jakichkolwiek lokalizacji rejestru potencjalnie odczytywanie danych, którego nie można zaufać.Ponadto RegQueryValueEx funkcji używanej przez tę metodę jawnie nie obsługuje ciągów, które są zakończone znakiem NULL.Oba warunki są sprawdzane dla przez kod wywołujący.