FONCTION SHRegGetValueFromHKCUHKLM (shlwapi.h)

[Cette fonction n’est plus prise en charge.]

Obtient les informations spécifiées à partir du Registre. Cette fonction case activée HKEY_CURRENT_USER pour les informations demandées dans la sous-clé spécifiée. Si les informations n’existent pas sous la sous-arborescence HKEY_CURRENT_USER, la fonction vérifie la HKEY_LOCAL_MACHINE sous-arborescence pour les mêmes informations.

Syntaxe

LSTATUS SHRegGetValueFromHKCUHKLM(
  [in]      PCWSTR pwszKey,
  [in]      PCWSTR pwszValue,
  [in]      SRRF   srrfFlags,
  [out]     DWORD  *pdwType,
  [in]      void   *pvData,
  [in, out] DWORD  *pcbData
);

Paramètres

[in] pwszKey

Type : PCWSTR

Pointeur vers une chaîne Unicode terminée par null qui spécifie le chemin d’accès à la clé de Registre.

[in] pwszValue

Type : PCWSTR

Pointeur vers une chaîne Unicode terminée par null qui spécifie la valeur de clé. Cette valeur peut être NULL, auquel cas les données sont récupérées à partir de la valeur Par défaut.

[in] srrfFlags

Type : SRRF

Constantes d’indicateur SRRF . Si plusieurs indicateurs sont utilisés, ils peuvent être combinés à l’aide d’un or au niveau du bit. Ces indicateurs sont utilisés pour restreindre le type de données retournées. Cette valeur ne peut pas être 0.

[out] pdwType

Type : DWORD*

Lorsque cette fonction retourne, contient un pointeur vers un DWORD qui reçoit un code qui indique le type de données stockées dans la valeur spécifiée. Cette valeur peut être définie sur NULL si aucune information de type n’est souhaitée. Si cette valeur n’est pas NULL et que l’indicateur SRRF_NOEXPAND n’a pas été défini, les types de données des REG_EXPAND_SZ sont retournés comme REG_SZ, car ils sont automatiquement développés dans cette méthode.

[in] pvData

Type : LPCVOID

Pointeur vers une mémoire tampon qui contient les données de la valeur. Ce paramètre peut avoir la valeur NULL si les données ne sont pas nécessaires. Cette valeur doit contenir la taille de la mémoire tampon pvData lors de l’entrée. Si pvData a la valeur NULL (ou si pvData n’a pas la valeur NULL, mais qu’il est trop petit d’une mémoire tampon pour contenir les données du Registre), à la sortie, elle contiendra la taille requise pour contenir les données du Registre.

[in, out] pcbData

Type : DWORD*

Lorsque cette fonction retourne, contient un pointeur vers la taille des données, en octets.

Valeur retournée

Type : LONG

Si elle réussit, cette fonction retourne ERROR_SUCCESS et tous les paramètres de sortie demandés. Retourne ERROR_MORE_DATA si la fonction échoue en raison d’un espace insuffisant dans un pvData non NULL fourni. Dans ce cas, seuls pdwType et pcbData peuvent contenir des données valides, pvData ne sera pas défini. Sinon, retourne 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 récupérer une description générique de l’erreur.

Configuration requise

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	shlwapi.h
DLL	Shlwapi.dll