RegLoadMUIStringA, fonction (winreg.h)

Article
03/04/2024

Charge la chaîne spécifiée à partir de la clé et de la sous-clé spécifiées.

Syntaxe

LSTATUS RegLoadMUIStringA(
  [in]            HKEY    hKey,
  [in, optional]  LPCSTR  pszValue,
  [out, optional] LPSTR   pszOutBuf,
  [in]            DWORD   cbOutBuf,
  [out, optional] LPDWORD pcbData,
  [in]            DWORD   Flags,
  [in, optional]  LPCSTR  pszDirectory
);

Paramètres

[in] hKey

Handle d’une clé de Registre ouverte. La clé doit avoir été ouverte avec le droit d’accès KEY_QUERY_VALUE. Pour plus d’informations, consultez Sécurité de la clé de Registre et droits d’accès.

Ce handle est retourné par la fonction RegCreateKeyEx ou RegOpenKeyEx . Il peut également s’agir de l’une des clés prédéfinies suivantes :

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_USERS

[in, optional] pszValue

Nom de la valeur de Registre.

[out, optional] pszOutBuf

Pointeur vers une mémoire tampon qui reçoit la chaîne.

Les chaînes du formulaire suivant reçoivent une gestion spéciale :

@[path]\dllname,-strID

La chaîne avec l’identificateur strID est chargée à partir de dllname ; le chemin d’accès est facultatif. Si le paramètre pszDirectory n’est pas NULL, le répertoire est ajouté au chemin spécifié dans les données du Registre. Notez que dllname peut contenir des variables d’environnement à développer.

[in] cbOutBuf

Taille de la mémoire tampon pszOutBuf , en octets.

[out, optional] pcbData

Pointeur vers une variable qui reçoit la taille des données copiées dans la mémoire tampon pszOutBuf , en octets.

Si la mémoire tampon n’est pas suffisamment grande pour contenir les données, la fonction retourne ERROR_MORE_DATA et stocke la taille de mémoire tampon requise dans la variable pointée par pcbData. Dans ce cas, le contenu de la mémoire tampon n’est pas défini.

[in] Flags

Ce paramètre peut être 0 ou la valeur suivante.

Valeur	Signification
REG_MUI_STRING_TRUNCATE 0x00000001	La chaîne est tronquée pour s’adapter à la taille disponible de la mémoire tampon pszOutBuf . Si cet indicateur est spécifié, pcbData doit avoir la valeur NULL.

[in, optional] pszDirectory

Chemin d'accès du répertoire.

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 système.

Si la mémoire tampon pcbData est trop petite pour recevoir la chaîne, la fonction retourne ERROR_MORE_DATA.

La version ANSI de cette fonction retourne ERROR_CALL_NOT_IMPLEMENTED.

Remarques

La fonction RegLoadMUIString est prise en charge uniquement pour Unicode. Bien que les versions Unicode (W) et ANSI (A) de cette fonction soient déclarées, la fonction RegLoadMUIStringA retourne ERROR_CALL_NOT_IMPLEMENTED. Les applications doivent appeler explicitement RegLoadMUIStringW ou spécifier Unicode comme jeu de caractères dans les appels pInvoke (platform invoke).

Pour compiler une application qui utilise cette fonction, définissez _WIN32_WINNT comme 0x0600 ou version ultérieure. Pour plus d’informations, consultez Utilisation des en-têtes Windows.

Notes

L’en-tête winreg.h définit RegLoadMUIString en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winreg.h (inclure Windows.h)
Bibliothèque	Advapi32.lib
DLL	Advapi32.dll

Voir aussi

Fonctions de Registre

Partager via