CRegKey::QueryValue

Makale
02/26/2013

Belirtilen değer alanını veri almak için bu yöntemi çağırın m_hKey.Bu yöntem eski sürümleri artık desteklenmemektedir ve olarak işaretlenen 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 
);

Parametreler

pszValueName
Sorguya değerinin adını içeren bir boş sonlandırılmış dize işaretçisi.pszValueName null veya boş bir dize ise "", yöntem türü alır ve anahtar veri adlandırılmamış veya varsayılan değer olarak, varsa.
pdwType
Belirtilen değer saklanan veri türünü gösteren bir kod alan değişken için işaretçi.pdwType Türü kodu gerekli değilse, parametre null olabilir.
pData
Değerin verisini alır arabellek için işaretçi.Veri gerekli değilse bu parametre null olabilir.
pnBytes
Tarafından için işaretçiyi arabelleğinin bayt cinsinden boyutunu belirtir bir değişkene ulaşılan pData parametresi.Yöntem geri döndüğünde, bu değişken kopyalanan verinin boyutunu içeren pData.
dwValue
Değer alanın sayısal veri.
lpszValueName
Sorgulanacak değer alanını belirtir.
szValue
Değer alanının dize verileri.
pdwCount
String veri boyutu.Değerini başlangıçta boyutuna ayarlayın szValue arabellek.

Dönüş Değeri

Başarılı olursa, error_success verir; Aksi takdirde WINERROR sıfır hata kodu tanımlı.H.

Notlar

İki özgün sürümü QueryValue artık desteklenmemektedir ve olarak işaretlenen atl_deprecated.Bu formlar kullanılıyorsa, derleyici uyarı verecek.

RegQueryValueEx kalan yöntemini çağırır.

Güvenlik Notu
Bu yöntem, büyük olasılıkla, güvenilmez bir veri okuma herhangi bir kayıt defteri konumu belirtmek arayan sağlar.Ayrıca, bu yöntem tarafından kullanılan RegQueryValueEx işlevini açıkça olan dizeleri işlemediğinden NULL sona erdi.Her iki koşul için çağıran kodun tarafından denetlenmelidir.