RegLoadMUIStringA, fonction (winreg.h)

Article
11/20/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 vers 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é des clés 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:

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 :

@[ chemin d’accès]\dllname,-strID

La chaîne avec 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 précédé du 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 la mémoire tampon requise dans la variable pointée par Dans ce cas, le contenu de la mémoire tampon n’est pas défini.

[in] Flags

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

Valeur	Signification
REG_MUI_STRING_TRUNCATE 0x00000001	La chaîne est tronquée pour correspondre à la taille disponible de la mémoire tampon pszOutBuf. Si cet indicateur est spécifié, doit être NULL.

[in, optional] pszDirectory

Chemin d’accès au répertoire.

Valeur de retour

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 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 d’appel de plateforme (PInvoke).

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

Note

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. Le mélange 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2008 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	winreg.h (inclure Windows.h)
bibliothèque	Advapi32.lib
DLL	Advapi32.dll

Voir aussi

fonctions de Registre

Partager via