CRegKey::QueryMultiStringValue

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

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

パラメーター

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

  • pszValue
    複数文字列データを受け取るバッファーへのポインター。複数文字列に 2 桁の null 文字で終了する null で終わる文字列の配列です。

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

戻り値

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

解説

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

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

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

必要条件

atlbase.hHeader:

参照

関連項目

CRegKey クラス

CRegKey::SetMultiStringValue

CRegKey::QueryBinaryValue

CRegKey::QueryDWORDValue

CRegKey::QueryGUIDValue

CRegKey::QueryQWORDValue

CRegKey::QueryStringValue