S'identifier

API
Documentation
Ressources
Trucs & astuces
Libre
Gabarits
Services

Membres
Participer
Visiter

Contact

Meilleure résolution
mode 800 x 600

Optimisé pour
IE v.5
Netscape v.6
mais surtout pour
Mozilla v.1
minimum

 


Membre de Click-FR®, Réseau francophone Paie-Par-Click

SHSetValue

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.

Syntaxe

AppelDLL32("shlwapi", "SHSetValueA", hkey, pszSubKey, pszValue, dwType, pvData, cbData)

hkey
[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)


Nombre de commentaire sur SHSetValue : 0

Rappel : Le code fourni est compatible Windev v.4 et 5. Pour les versions supérieures, vous devez modifier le type des variables numériques. Par exemple : entier long devient entier.
Bien sûr, les marques citées sont déposées par leurs sociétés respectives. Ces pages sont à la disposition de tous, le code fourni est libre mais toute responsabilité est déclinée en cas de mauvais usage ou de dysfonctionnement.
© 2000-2005 Beaussier & Le Centre W..D..