CRegKey::QueryStringValue

Article
03/04/2013

Appelez cette méthode pour récupérer les données de chaîne pour le nom de la valeur spécifiée.

LONG QueryStringValue(
   LPCTSTR pszValueName,
   LPTSTR pszValue,
   ULONG* pnChars 
) throw( );

Paramètres

pszValueName
Pointeur vers une chaîne terminée par le caractère NULL contenant le nom de la valeur pour interroger.
pszValue
Pointeur vers une mémoire tampon qui reçoit les données de chaîne.
pnChars
La taille, dans TCHARs, de la mémoire tampon a globale pointe vers pszValue.Lorsque la méthode retourne, pnChars contient la taille, dans TCHARs, de la chaîne extraite, y compris un caractère NULL de fin.

Valeur de retour

Si la méthode réussit, ERROR_SUCCESS est retourné.Si la méthode ne lit pas de valeur, elle retourne un code d'erreur différent de zéro défini dans WINERROR.H.Si les données référencées ne sont pas du type REG_SZ, ERROR_INVALID_DATA est retourné.Si la méthode retourne ERROR_MORE_DATA, pnChars est égal à zéro, pas la taille de mémoire tampon requise en octets.

Notes

Cette méthode utilise de RegQueryValueEx et le confirme que le type de données approprié est retourné.Consultez RegQueryValueEx pour plus de détails.

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.