CRegKey::QueryValue

Artikel
06/09/2015

Rufen Sie diese Methode auf, um die Daten für das angegebene Wertsfeld von m_hKey abzurufen. Frühere Versionen dieser Methode werden nicht mehr unterstützt und werden als ATL_DEPRECATED markiert.

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  
);

Parameter

pszValueName
Zeiger auf eine auf NULL endende Zeichenfolge, die den Namen des Werts enthält, um abzufragen. Wenn pszValueName NULL oder eine leere Zeichenfolge "", ist die Methode abruft, den Typ und die Daten für die unbenannte Schlüssel oder Standardwert, sofern vorhanden.
pdwType
Zeiger auf eine Variable, die einen Code erhält, der den Datentyp angibt, die im angegebenen Wert gespeichert werden. Der pdwType-Parameter kann NULL sein, wenn der Typencode nicht erforderlich ist.
pData
Zeiger auf einen Puffer, der die Daten des Werts erhält. Dieser Parameter kann NULL sein, wenn die Daten nicht erforderlich sind.
pnBytes
Zeiger auf eine Variable, die die Größe, in Bytes, des Puffers angibt, auf die durch den pData-Parameter. Wenn die Methode zurückgibt, enthält diese Variable die Größe der Daten, die nach pData kopiert werden.
dwValue
Die numerischen Daten des Wertfelds.
lpszValueName
Gibt das abzufragende Wertfeld an.
szValue
Die Zeichenfolgendaten des Wertfelds.
pdwCount
Die Größe der Zeichenfolgendaten. Der Wert wird zuerst auf die Größe des Puffers szValue festgelegt.

Rückgabewert

Wenn erfolgreich, gibt ERROR_SUCCESS; andernfalls ein Fehlercode ungleich 0 (null) definiert in WINERROR.H.

Hinweise

Die beiden ursprüngliche von QueryValue werden nicht mehr unterstützt und werden als ATL_DEPRECATED markiert. Der Compiler gibt eine Warnung aus, wenn diese Formulare verwendet werden.

Die übrigen Methodenaufrufe RegQueryValueEx.

Sicherheitshinweis
Diese Methode kann der Aufrufer, um beliebigen Registrierungsspeicherort anzugeben und möglicherweise liest Daten, die nicht vertrauenswürdig sind.Auch die RegQueryValueEx-Funktion, die von verwendet wird, nicht explizit behandelt Zeichenfolgen, die NULL endeten sind.Beide Bedingungen sollten für durch den Aufrufcode überprüft werden.