IVsSettingsReader.ReadSettingBytes(String, Byte, Int32, Int32) Methode

Definition

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

Int32

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.

Gilt für