Date de parution : 24/11/2003
- Cette fiche API a été lue 1054 fois
Description
SHSetValue place une valeur dans la base de registre. La fonction retourne ERROR_SUCCESS (0) en cas de succès et un code erreur différent de zéro défini dans Winerror.h dans les autres cas. Vous pouvez utiliser FormatMessage avec le sémaphore FORMAT_MESSAGE_FROM_SYSTEM pour récupérer la description générique de l'erreur.
[e] Handle de la clé à ouvrir défini par les valeurs suivantes :
HKEY_CLASSES_ROOT
2147483648
HKEY_CURRENT_CONFIG
2147483653
HKEY_CURRENT_USER
2147483649
HKEY_DYN_DATA
(Windows 95 seulement)
2147483654
HKEY_LOCAL_MACHINE
2147483650
HKEY_PERFORMANCE_DATA
(Windows NT seulement)
2147483652
HKEY_USERS
2147483651
pszSubKey
[e] Pointeur vers une chaîne à terminateur nul qui spécifie le nom de la sous-clé. La valeur peut être à Null ou pointer sur une chaîne vide, dans ce cas la valeur sera ajoutée à la clé identifié par hkey.
pszValue
[e] Pointeur vers une chaîne à terminateur nul qui spécifie la valeur.
dwType
[e] Type de donnée à stocker. Ce paramètre doit être de type REG_SZ.
pvData
[e] Pointeur vers une chaîne à terminateur nul qui spécifie le contenu de la valeur.
cbData
[e] Taille de la chaîne pvData.
Compatibilité
Supporté pour toutes les versions avec shlwapi.dll version 4.71 minimum
Remarque
Aucune
Exemple 1
// Ajouter une clé et une valeur dans le registre
hKey est un entier long
pszSubKey est une chaîne Asciiz sur 255
pszValue est une chaîne Asciiz sur 255
pvData est une chaîne Asciiz sur 255
// Du code offert par Beaussier en ligne !
hKey = 2147483649 // HKCU
pszSubKey = "Environnement"
pszValue = "ValeurExemple"
pvData = "Test de texte"
AppelDLL32("shlwapi", "SHSetValueA", ...
hKey, &pszSubKey, &pszValue, 2, &pvData, 255)