次の方法で共有


CRegKey::QueryStringValue

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

LONG QueryStringValue(
   LPCTSTR pszValueName,
   LPTSTR pszValue,
   ULONG* pnChars 
) throw( );

パラメーター

  • pszValueName
    照会する値の名前を含む null で終わる文字列へのポインター。

  • pszValue
    文字列データを受け取るバッファーへのポインター。

  • pnChars
    バッファーのサイズは、TCHAR で、pszValueが指す。メソッドから制御が戻るときに、pnChars は、終端の null 文字を格納および取得する文字列の TCHAR で、サイズを格納します。

戻り値

メソッドが成功した場合、ERROR_SUCCESS が返されます。メソッドが値を読み取る WINERROR.H で定義されている以外のエラー コードを返します。参照されるデータが REG_SZ 型である、ERROR_INVALID_DATA が返されます。メソッドがを返した場合、ERROR_MORE_DATA pnChars は、バイト必要なバッファー サイズではなくになります。

解説

このメソッドは、正しい型のデータが返されることを確認します RegQueryValueEx を使用します。RegQueryValueEx を詳細については、" "を参照してください。

セキュリティに関するメモセキュリティに関するメモ

このメソッドは、呼び出し元には、信頼できないデータを読み取るレジストリの場所を指定することができます。また、使用される RegQueryValueEx の関数は、このメソッドによって明示的に終了する null である文字列を処理しません。両方の条件を呼び出し元のコードからのチェックする必要があります。

必要条件

ヘッダー: atlbase.h

参照

関連項目

CRegKey クラス

CRegKey::SetStringValue

CRegKey::QueryBinaryValue

CRegKey::QueryDWORDValue

CRegKey::QueryGUIDValue

CRegKey::QueryMultiStringValue

CRegKey::QueryQWORDValue