ORSetValue fonction)
Définit les données pour la valeur d’une clé de Registre spécifiée dans une ruche de Registre hors connexion.
Syntaxe
DWORD ORSetValue(
_In_ ORHKEY Handle,
_In_opt_ PCWSTR lpValueName,
_In_ DWORD dwType,
_In_opt_ const BYTE *lpData,
_In_ DWORD cbData
);
Paramètres
-
Gérer [ dans]
-
Handle d’une clé de Registre ouverte dans une ruche de Registre hors connexion.
-
lpValueName [ dans, facultatif]
-
Nom de la valeur à définir. Si une valeur portant ce nom n’est pas déjà présente dans la clé, la fonction l’ajoute à la clé.
Si lpValueName a la valeur null ou est une chaîne vide, "", la fonction définit le type et les données pour la valeur sans nom ou par défaut de la clé.
Pour plus d’informations, consultez limites de taille des éléments du Registre.
Les clés de Registre n’ont pas de valeurs par défaut, mais elles peuvent avoir une valeur sans nom, qui peut être de n’importe quel type.
-
dwType [ dans]
-
Type de données vers lequel pointe le paramètre lpData . Pour obtenir la liste des types possibles, consultez types de valeurs de Registre.
-
lpData [ dans, facultatif]
-
Données à stocker.
Pour les types basés sur une chaîne, tels que REG _ SZ, la chaîne doit se terminer par un caractère null. Pour le _ type de données Reg multi- _ SZ, la chaîne doit se terminer par deux caractères null.
-
cbData [ dans]
-
Taille des informations vers lesquelles pointe le paramètre lpData , en octets. Si les données sont de type REG _ SZ, reg _ expand _ SZ ou reg _ _ multisz, cbData doit inclure la taille du ou des caractères null de fin.
Valeur retournée
Si la fonction réussit, la valeur de retour est une erreur de _ réussite.
Si la fonction échoue, la valeur de retour est un code d’erreur différent de zéro défini dans Winerror. h. Vous pouvez utiliser la fonction FormatMessage avec le format _ message _ de l' _ indicateur système pour obtenir une description générique de l’erreur.
Remarques
Les tailles de valeur sont limitées par la mémoire disponible. Les valeurs longues (plus de 2048 octets) doivent être stockées sous forme de fichiers avec les noms de fichiers stockés dans le registre. Cela permet au registre de fonctionner efficacement. Les éléments d’application, tels que les icônes, les bitmaps et les fichiers exécutables, doivent être stockés en tant que fichiers et ne peuvent pas être placés dans le registre.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Composant redistribuable |
Windows Bibliothèque de Registre hors connexion version 1,0 ou ultérieure |
| En-tête |
|
| DLL |
|