CRegKey::QueryValue

Artykuł
02/27/2013

Wywołanie tej metody do pobierania danych dla określonej wartości pola z m_hKey.Wcześniejsze wersje tej metody nie są już obsługiwane i są oznaczone jako 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 
);

Parametry

pszValueName
Wskaźnik, aby ciąg zakończony zerem zawierającego nazwę wartości do kwerendy.Jeśli pszValueName jest ZEROWY lub pusty ciąg "", metoda pobiera typ i danych klucza na nienazwane lub wartość domyślna, jeśli istnieje.
pdwType
Wskaźnik do zmiennej, która otrzymuje kod wskazujący typ danych przechowywanych w określonej wartości.pdwType Parametr może być NULL, jeśli kod typu nie jest wymagane.
pData
Wskaźnik do buforu, który odbiera dane wartości.Ten parametr może być NULL, jeśli nie jest wymagane dane.
pnBytes
Wskaźnik do zmiennej, która określa rozmiar w bajtach bufora wskazywanego przez pData parametru.Gdy metoda zwraca, ta zmienna zawiera rozmiar danych skopiowanych do pData.
dwValue
Pole wartość danych liczbowych.
lpszValueName
Określa wartość pola powinna dotyczyć kwerenda.
szValue
Pole wartość ciągu danych.
pdwCount
Rozmiar danych string.Jego wartość jest początkowo ustawiona rozmiar szValue buforu.

Wartość zwracana

Jeśli się powiedzie, zwraca ERROR_SUCCESS; w przeciwnym razie kod błędu niezerową zdefiniowane w powiodło się.H.

Uwagi

Dwie wersje oryginalne QueryValue nie są już obsługiwane i są oznaczone jako ATL_DEPRECATED.Kompilator wygeneruje ostrzeżenie, jeśli używane są te formularze.

Pozostałe wywołania metody RegQueryValueEx.

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 funkcja RegQueryValueEx używane przez tę metodę nie obsługuje jawnie ciągów, które są NULL zakończone.Oba warunki są sprawdzane dla przez kod wywołujący.