CRegKey::SetValue

Artykuł
02/27/2013

Wywołanie tej metody przechowywania danych w dziedzinie określonej wartości m_hKey.Wcześniejsze wersje tej metody nie są już obsługiwane i są oznaczone jako 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
);

Parametry

pszValueName
Ciąg zawierający nazwę wartość należy ustawić wskaźnik.Jeśli wartość o tej nazwie nie jest już obecny w kluczu, metoda dodaje go do klucza.Jeśli pszValueName jest ZEROWY lub pusty ciąg "", metoda ustawia typ i danych klucza na nienazwane lub wartość domyślna.
dwType
Określa kod wskazujący typ danych wskazywanej przez pValue parametru.
pValue
Wskaźnik do bufora zawierającego dane, które mają być przechowywane z nazwą określoną wartość.
nBytes
Określa rozmiar w bajtach informacji wskazywanej przez pValue parametru.Jeśli dane typu REG_SZ, REG_EXPAND_SZ czy REG_MULTI_SZ, nBytes muszą zawierać wielkość kończącego znaku null.
hKeyParent
Dojście otwartego klucza.
lpszKeyName
Określa nazwę klucza, należy utworzyć lub otworzyć.Nazwa ta musi być podkluczem hKeyParent.
lpszValue
Określa dane mają być przechowywane.Ten parametr musi być NIEZEROWA.
lpszValueName
Określa pole wartość należy ustawić.Jeśli wartość pola o tej nazwie już istnieje w kluczu, jest dodawany.
dwValue
Określa dane mają być przechowywane.
bMulti
Jeśli FAŁSZ, wskazuje, że ciąg jest typu REG_SZ.Jeśli wartość true, wskazuje, że ciąg jest ciągu wielokrotnego typu REG_MULTI_SZ.
nValueLen
Jeśli bMulti ma wartość true, nValueLen jest długość lpszValue ciąg znaków.Jeśli bMulti ma wartość false, wartość -1 wskazuje, że metoda automatycznie obliczy długość.

Wartość zwracana

Jeśli się powiedzie, zwraca ERROR_SUCCESS; w przeciwnym razie kod błędu niezerową zdefiniowane w powiodło się.H.

Uwagi

Dwie wersje oryginalne SetValue są oznaczone jako ATL_DEPRECATED i nie powinny być używane.Kompilator wygeneruje ostrzeżenie, jeśli używane są te formularze.

Trzeci wywołania metody RegSetValueEx.