CRegKey::QueryMultiStringValue

Artikel
06/09/2015

Rufen Sie diese Methode auf, um die Daten der mehrteiligen Zeichenfolge für einen angegebenen Wertnamen abzurufen.

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

Parameter

pszValueName
Zeiger auf eine auf NULL endende Zeichenfolge, die den Namen des Werts enthält, um abzufragen.
pszValue
Zeiger auf einen Puffer, der die Daten der mehrteiligen Zeichenfolge empfängt. Eine mehrteilige Zeichenfolge ist ein Array auf NULL endende Zeichenfolgen, beendet durch zwei NULL-Zeichen.
pnChars
Die Größe, in TCHARs, des Puffers wurde auf durch pszValue. Wenn die Methode zurückgibt, enthält pnChars die Größe, in TCHARs, der abgerufenen mehrteiligen Zeichenfolge, einschließlich ein NULL.

Rückgabewert

Wenn die Methode erfolgreich ist, wird ERROR_SUCCESS zurückgegeben. Wenn die Methode einen Wert nicht lesen kann, wird ein Fehlercode ungleich 0 (null) zurück, der in WINERROR.H. definiert ist. Wenn die referenzierten keine Daten vom Typ REG_MULTI_SZ sind, wird ERROR_INVALID_DATA zurückgegeben.

Hinweise

Diese Methode verwendet RegQueryValueEx aus und bestätigt, dass der richtige Typ von Daten zurückgegeben wird. Siehe RegQueryValueEx für weitere Details.

Sicherheitshinweis
Diese Methode kann der Aufrufer, um beliebigen Registrierungsspeicherort anzugeben und möglicherweise liest Daten, die nicht vertrauenswürdig sind.Auch die RegQueryValueEx-Funktion, die von verwendet wird, nicht explizit behandelt Zeichenfolgen, die beendet NULL sind.Beide Bedingungen sollten für durch den Aufrufcode überprüft werden.