CRegKey::SetValue
Rufen Sie diese Methode auf, um Daten auf dem angegebenen Wertsgebiet von m_hKey zu speichern. Frühere Versionen dieser Methode werden nicht mehr unterstützt und werden als ATL_DEPRECATED markiert.
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
);
Parameter
pszValueName
Zeiger auf eine Zeichenfolge, die den Namen des Werts festzulegende enthält. Wenn ein Wert mit diesem Namen nicht bereits in der Schlüssel vorhanden ist, fügt die Methode sie der Schlüssel hinzu. Wenn pszValueName ist, legt NULL oder eine leere Zeichenfolge, "", die Methode den Typ und die Daten für die unbenannte Schlüssel oder Standardwert fest.dwType
Gibt einen Code an, der den Datentyp angibt, die von dem pValue-Parameter angezeigt werden.pValue
Zeiger auf einen Puffer, der die mit dem angegebenen Wertnamen gespeichert werden, Daten enthält.nBytes
Gibt die Größe, in Bytes, der Informationen an, die von dem pValue-Parameter angezeigt werden. Wenn die Daten vom Typ REG_SZ, REG_EXPAND_SZ oder REG_MULTI_SZ sind, muss nBytes die Größe des NULL einschließen.hKeyParent
Das Handle einer geöffneten Schlüssel.lpszKeyName
Gibt den Namen einer erstellt sein an oder geöffnet wurde, Schlüssel. Dieser Name muss ein Unterschlüssel von hKeyParent sein.lpszValue
Gibt die zu speichernden Daten, an. Dieser Parameter muss ungleich null sein.lpszValueName
Gibt das festgelegt werden, anfeld Werts. Wenn ein Wertsfeld mit diesem Namen nicht bereits in der Schlüssel vorhanden ist, wird es hinzugefügt.dwValue
Gibt die zu speichernden Daten, an.bMulti
Wenn false, angibt, ist die Zeichenfolge vom Typ REG_SZ. Bei "true", gibt die Zeichenfolge ist eine mehrteilige Zeichenfolge des Typs REG_MULTI_SZ an.nValueLen
Wenn bMulti zutrifft, ist nValueLen die Länge der Zeichenfolge lpszValue in Zeichen. Wenn bMulti falsch ist, ein Wert von -1 gibt an, dass die Methode die Länge automatisch berechnet.
Rückgabewert
Wenn erfolgreich, gibt ERROR_SUCCESS; andernfalls ein Fehlercode ungleich 0 (null) definiert in WINERROR.H.
Hinweise
Die beiden ursprüngliche von SetValue werden als ATL_DEPRECATED markiert und sollten nicht mehr verwendet werden. Der Compiler gibt eine Warnung aus, wenn diese Formulare verwendet werden.
Die dritte Methodenaufrufe RegSetValueEx.
Anforderungen
Header: atlbase.h