CRegKey::QueryDWORDValue

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

指定された値名の DWORD データを取得します。

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

パラメータ

pszValueName
照会する値の名前を含む Null で終わる文字列を指すポインタ。
dwValue
DWORD を受け取るバッファへのポインタ。

戻り値

メソッドが成功した場合は、ERROR_SUCCESS が返されます。値の読み取りに失敗すると、WINERROR.H で定義されている 0 以外のエラーコードを返します。参照されるデータが REG_DWORD 型でない場合は、ERROR_INVALID_DATA を返します。

解説

このメソッドは、RegQueryValueEx を使用し、正しい種類のデータが返されたかどうかを確認します。詳細については、RegQueryValueEx の説明を参照してください。

セキュリティに関するメモ :
呼び出し元では、このメソッドを使用してレジストリの場所を指定できますが、信頼性の低いデータが読み込まれる可能性があります。また、このメソッドが使用する RegQueryValueEx 関数は、NULL で終わる文字列を明示的に処理しません。これらの条件については、呼び出し元のコードで確認する必要があります。

呼び出し元では、このメソッドを使用してレジストリの場所を指定できますが、信頼性の低いデータが読み込まれる可能性があります。また、このメソッドが使用する RegQueryValueEx 関数は、NULL で終わる文字列を明示的に処理しません。これらの条件については、呼び出し元のコードで確認する必要があります。