IVsSettingsReader.ReadSettingBytes(String, Byte, Int32, Int32) 方法

定义

返回存储在 Visual Studio 设置文件中的数组值。

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

参数

pszSettingName
String

中用于唯一标识要检索的数据元素的字符串。

pSettingValue
Byte

[in,out]用于接收从 Visual Studio 设置文件的指定数据元素检索到的字节数据的缓冲区。

plDataLength
Int32

弄返回的字节值数。

lDataMax
Int32

中要返回的最大字节数。 如果存储的数据的大小大于 lDataMax ,则返回错误。

返回

Int32

如果该方法成功,则它会返回 S_OK。 如果该方法失败,则会返回错误代码。

注解

的值 plDataLength 必须始终小于或等于 lDataMax.

用于接收检索到的数据 () 的任何缓冲区的 pSettingValue 大小至少应为 lDataMax 个字节。

指定的名称 pfSettingValue 需要在自定义设置点中是唯一的,因为 IDE 使用标识 GUID 的自定义设置点和的值 pfSettingValue 来标识每个保存的设置。

由于的值 pfSettingValue 必须是唯一的,因此,对接口的 ReadSettingBytes 其他方法调用方法的顺序 IVsSettingsReader 是不相关的。

适用于