CRegKey::QueryBinaryValue

Artikel
06/09/2015

Rufen Sie diese Methode auf, um die Binärdaten für einen bestimmten Wertnamen abzurufen.

LONG QueryBinaryValue( 
   LPCTSTR pszValueName, 
   void* pValue, 
   ULONG* pnBytes  
) throw( );

Parameter

pszValueName
Zeiger auf eine auf NULL endende Zeichenfolge, die den Namen des Werts enthält, um abzufragen.
pValue
Zeiger auf einen Puffer, der die Daten des Werts erhält.
pnBytes
Zeiger auf eine Variable, die die Größe, in Bytes, des Puffers angibt, auf die durch den pValue-Parameter. Wenn die Methode zurückgibt, enthält diese Variable die Größe der Daten, die in den Puffer kopiert werden.

Rückgabewert

Wenn die Methode erfolgreich ist, wird ERROR_SUCCESS zurückgegeben. Wenn die Methode einen Wert nicht lesen kann, wird ein Fehlercode ungleich 0 (null) zurück, der in WINERROR.H. definiert ist. Wenn die referenzierten keine Daten vom Typ REG_BINARY sind, wird ERROR_INVALID_DATA zurückgegeben.

Hinweise

Diese Methode verwendet RegQueryValueEx aus und bestätigt, dass der richtige Typ von Daten zurückgegeben wird. Siehe RegQueryValueEx für weitere Details.

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 beendet NULL sind.Beide Bedingungen sollten für durch den Aufrufcode überprüft werden.