CRegKey::SetValue
m_hKey の指定された値フィールドにデータを格納します。以前のバージョンのこのメソッドはサポートされず、ATL_DEPRECATED のマークが付いています。
LONG SetValue(
LPCTSTR pszValueName,
DWORD dwType,
const void* pValue,
ULONG nBytes
) throw( );
static LONG WINAPI SetValue(
HKEY hKeyParent,
LPCTSTR lpszKeyName,
LPCTSTR lpszValue,
LPCTSTR lpszValueName = NULL);
ATL_DEPRECATED LONG SetValue(
DWORD dwValue,
LPCTSTR lpszValueName
);
ATL_DEPRECATED LONG SetValue(
LPCTSTR lpszValue,
LPCTSTR lpszValueName = NULL,
bool bMulti = false,
int nValueLen = -1
);
パラメーター
pszValueName
セットに値の名前を含む文字列へのポインター。この名前の値が既存キーにない場合、メソッドはキーに追加します。pszValueName がある場合は NULL または空の文字列""は、メソッドのないキーまたは既定の型およびデータを設定します。dwType
pValue のパラメーターが指すデータの型を示すコードを指定します。pValue
指定された値名と格納するデータを含むバッファーへのポインター。nBytes
、pValue のパラメーターが指す情報のサイズ (バイト単位) を指定します。データ型が、REG_EXPAND_SZ REG_SZ、または REG_MULTI_SZ 場合、nBytes には、終端の NULL 文字のサイズを含める必要があります。hKeyParent
開いているキーのハンドル。lpszKeyName
作成するキーまたは開くキーの名前を指定します。この名前は hKeyParentのサブキーである必要があります。lpszValue
格納するデータを指定します。このパラメーターが null 以外である必要があります。lpszValueName
設定する値フィールドを指定します。この名前のキー フィールドに値が存在しない場合、に追加されます。dwValue
格納するデータを指定します。bMulti
false の場合、文字列が REG_SZ 型であることを示します。true の場合、文字列が REG_MULTI_SZ 型の複数文字列であることを示します。nValueLen
bMulti が true の場合、nValueLen は、文字の lpszValue 文字列の長さです。bMulti が false の場合は値 -1 は、メソッドが長を自動的に計算することを示します。
戻り値
成功した場合、は、ERROR_SUCCESS; それ以外の場合は、WINERROR.H で定義されている以外のエラー コード。
解説
SetValue の 2 種類の元のバージョンが ATL_DEPRECATED としてマークされ、今後は使用しないでください。コンパイラは、これらのフォームが使用されている場合、警告が出力されます。
3 番目のメソッドは RegSetValueExを呼び出します。
必要条件
ヘッダー: atlbase.h