IVsSettingsReader.ReadSettingBytes(String, Byte, Int32, Int32) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt die Werte eines Arrays zurück, das in der Visual Studio-Einstellungsdatei gespeichert ist.
public:
int ReadSettingBytes(System::String ^ pszSettingName, [Runtime::InteropServices::Out] System::Byte % pSettingValue, [Runtime::InteropServices::Out] int % plDataLength, int lDataMax);
int ReadSettingBytes(std::wstring const & pszSettingName, [Runtime::InteropServices::Out] byte & pSettingValue, [Runtime::InteropServices::Out] int & plDataLength, int lDataMax);
public int ReadSettingBytes (string pszSettingName, out byte pSettingValue, out int plDataLength, int lDataMax);
abstract member ReadSettingBytes : string * byte * int * int -> int
Public Function ReadSettingBytes (pszSettingName As String, ByRef pSettingValue As Byte, ByRef plDataLength As Integer, lDataMax As Integer) As Integer
Parameter
- pszSettingName
- String
[in] Zeichenfolge, die das abzurufende Datenelement eindeutig identifiziert.
- pSettingValue
- Byte
[in, out] Puffer zum Empfangen von Byte Daten, die aus dem angegebenen Datenelement der Visual Studio-Einstellungsdatei abgerufen werden.
- plDataLength
- Int32
[out] Die Anzahl der zurückgegebenen Bytewerte.
- lDataMax
- Int32
[in] Maximale Anzahl der zurückzugebenden Bytes. Wenn die Größe der gespeicherten Daten größer als ist lDataMax , wird ein Fehler zurückgegeben.
Gibt zurück
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Bei einem Fehler wird ein Fehlercode zurückgegeben.
Hinweise
Der Wert von plDataLength muss immer kleiner oder gleich sein. lDataMax.
Jeder Puffer, der zum Empfangen der abgerufenen Daten () verwendet wird, muss mindestens pSettingValue lDataMax Bytes groß sein.
Die durch angegebenen Namen pfSettingValue müssen innerhalb eines benutzerdefinierten Einstellungs Punkts eindeutig sein, da die IDE den benutzerdefinierten Einstellungs Punkt verwendet, der die GUID und den Wert von identifiziert, pfSettingValue um jede gespeicherte Einstellung zu identifizieren.
Da der Wert von pfSettingValue eindeutig sein muss, ist die Reihenfolge, in der die- ReadSettingBytes Methode in Bezug auf andere Methoden der-Schnittstelle aufgerufen wird, IVsSettingsReader nicht relevant.