CRegKey::QueryValue

Article
06/09/2015

Appelez cette méthode pour récupérer les données du champ de valeur spécifié de m_hKey. Les versions antérieures de cette méthode sont plus prises en charge et ne sont marquées comme ATL_DEPRECATED.

LONG QueryValue( 
   LPCTSTR pszValueName, 
   DWORD* pdwType, 
   void* pData, 
   ULONG* pnBytes 
) throw( ); 
ATL_DEPRECATED LONG QueryValue( 
   DWORD& dwValue, 
   LPCTSTR lpszValueName  
); 
ATL_DEPRECATED LONG QueryValue( 
   LPTSTR szValue, 
   LPCTSTR lpszValueName, 
   DWORD* pdwCount  
);

Paramètres

pszValueName
Pointeur vers une chaîne terminée par le caractère NULL contenant le nom de la valeur pour interroger. Si pszValueName est NULL ou une chaîne vide, "", la méthode extrait le type et les données de la clé ou sans nom par défaut éventuelle.
pdwType
Le pointeur à une variable qui accepte un code indiquant le type de données stockées dans une valeur spécifiée. Le paramètre d' pdwType peut être NULL si le code de type n'est pas obligatoire.
pData
Pointeur vers une mémoire tampon qui reçoit les données de la valeur. Ce paramètre peut être NULL si les données ne sont pas requises.
pnBytes
Le pointeur à une variable qui spécifie la taille, en octets, de la mémoire tampon a globale pointe vers pData le paramètre. Lorsque la méthode retourne, cette variable contient la taille des données copiées vers pData.
dwValue
Les données numériques de champ de valeur.
lpszValueName
Spécifie le champ de valeur à interroger.
szValue
Les données de chaîne de valeur.
pdwCount
La taille des données de chaîne. Sa valeur est initialement définie à la taille de la mémoire tampon d' szValue .

Valeur de retour

En cas de réussite, retourne ERROR_SUCCESS ; sinon, le code d'erreur différent de zéro défini dans WINERROR.H.

Notes

Les deux versions originales d' QueryValue sont plus prises en charge et ne sont marquées comme ATL_DEPRECATED. Le compilateur émet un avertissement si ces formes sont utilisées.

Les appels de méthode restants RegQueryValueEx.

Note de sécurité
Cette méthode permet à l'appelant de spécifier un emplacement de Registre, lisant contenir des données qui ne peuvent pas être de confiance.En outre, la fonction de RegQueryValueEx utilisée par cette méthode ne gère pas explicitement les chaînes qui sont NULL terminées.Les deux conditions doivent être examinées pour rechercher par le code appelant.