FONCTION ORSetValue

Article
06/13/2023

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

Handle [in]

Handle d’une clé de Registre ouverte dans une ruche de Registre hors connexion.

lpValueName [in, facultatif]

Nom de la valeur à définir. Si aucune valeur portant ce nom n’est déjà présente dans la clé, la fonction l’ajoute à la clé.

Si lpValueName a la valeur NULL ou une chaîne vide, « », la fonction définit le type et les données de la valeur sans nom ou par défaut de la clé.

Pour plus d’informations, consultez Limites de taille des éléments de 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 [in]

Type de données vers lequel pointe le paramètre lpData . Pour obtenir la liste des types possibles, consultez Types valeur du Registre.

lpData [in, facultatif]

Données à stocker.

Pour les types basés sur des chaînes, tels que REG_SZ, la chaîne doit être terminée par null. Pour le type de données REG_MULTI_SZ, la chaîne doit se terminer par deux caractères Null.

cbData [in]

Taille des informations pointées par le paramètre lpData , en octets. Si les données sont de type REG_SZ, REG_EXPAND_SZ ou REG_MULTI_SZ, 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 ERROR_SUCCESS.

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 l’indicateur FORMAT_MESSAGE_FROM_SYSTEM pour obtenir une description générique de l’erreur.

Notes

Les tailles de valeur sont limitées par la mémoire disponible. Les valeurs longues (plus de 2 048 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 doivent pas être placés dans le Registre.

Spécifications

Condition requise	Valeur
Composant redistribuable	Bibliothèque du Registre windows hors connexion version 1.0 ou ultérieure
En-tête	Offreg.h
DLL	Offreg.dll

Voir aussi

ORCreateKey
OROpenKey

Partager via