Freigeben über


CRegKey::QueryDWORDValue

Rufen Sie diese Methode auf, um die DWORD-Daten für einen angegebenen Wertnamen abzurufen.

LONG QueryDWORDValue( 
   LPCTSTR pszValueName, 
   DWORD& dwValue  
) throw( );

Parameter

  • pszValueName
    Zeiger auf eine auf NULL endende Zeichenfolge, die den Namen des Werts enthält, um abzufragen.

  • dwValue
    Zeiger auf einen Puffer, der das DWORD empfängt.

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_DWORD-Wert 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.

SicherheitshinweisSicherheitshinweis

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.

Anforderungen

Header: atlbase.h

Siehe auch

Referenz

CRegKey Class

CRegKey::SetDWORDValue

CRegKey::QueryBinaryValue

CRegKey::QueryGUIDValue

CRegKey::QueryMultiStringValue

CRegKey::QueryQWORDValue

CRegKey::QueryStringValue