CRegKey::QueryMultiStringValue

Article
06/09/2015

Appelez cette méthode pour récupérer les données à plusieurs chaînes pour un nom de valeur spécifiée.

LONG QueryMultiStringValue( 
   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 à plusieurs chaînes. Un à plusieurs chaînes est un tableau de chaînes terminée par le caractère NULL, effectué par deux caractères Null.
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 l'extrait à plusieurs chaînes, 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_MULTI_SZ, ERROR_INVALID_DATA est retourné.

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.