CRegKey::SetValue
Appelez cette méthode pour enregistrer des données dans le domaine de valeur spécifié de m_hKey.Les versions antérieures de cette méthode sont plus prises en charge et ne sont marquées comme 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
);
Paramètres
pszValueName
Pointeur vers une chaîne contenant le nom de la valeur à définir.Si une valeur avec ce nom n'est pas déjà présente dans la clé, la méthode l'ajoute à la clé.Si pszValueName est NULL ou une chaîne vide, "", la méthode définit le type et les données de la clé ou sans nom par défaut.dwType
Spécifie un code indiquant le type de données globale pointe vers le paramètre d' pValue .pValue
Pointeur vers une mémoire tampon qui contient les données à enregistrer avec le nom de la valeur spécifiée.nBytes
Spécifie la taille, en octets, des informations sur pointées par le paramètre d' pValue .Si les données sont de type REG_SZ, REG_EXPAND_SZ, ou REG_MULTI_SZ, nBytes doit inclure la taille du caractère NULL de fin.hKeyParent
Le handle d'une clé ouverte.lpszKeyName
Spécifie le nom d'une clé à créer ou être ouverte.Ce nom doit être une sous-clé d' hKeyParent.lpszValue
Spécifie les données à stocker.Ce paramètre doit être non null.lpszValueName
Spécifie le champ de valeur à définir.Si un champ de valeur avec ce nom n'existe pas déjà dans la clé, il est ajouté.dwValue
Spécifie les données à stocker.bMulti
Si la valeur false, indique la chaîne est de type REG_SZ.Si la valeur true, indique la chaîne est un à plusieurs chaînes du type REG_MULTI_SZ.nValueLen
Si bMulti est true, nValueLen est la longueur de la chaîne de lpszValue caractères.Si bMulti a la valeur false, une valeur de -1 indique que la méthode calculera la longueur automatiquement.
Valeur de retour
En cas de réussite, retourne ERROR_SUCCESS ; sinon, le code d'erreur différent de zéro défini dans WINERROR.H.
Notes
Les deux versions originales d' SetValue sont marquées comme ATL_DEPRECATED et doit plus être utilisées.Le compilateur émet un avertissement si ces formes sont utilisées.
Le troisième appels de méthode RegSetValueEx.
Configuration requise
Header: atlbase.h