IVsSettingsReader.ReadSettingBytes(String, Byte, Int32, Int32) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
返回存储在 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 ,则返回错误。
返回
如果该方法成功,则它会返回 S_OK。 如果该方法失败,则会返回错误代码。
注解
的值 plDataLength 必须始终小于或等于 lDataMax.
用于接收检索到的数据 () 的任何缓冲区的 pSettingValue 大小至少应为 lDataMax 个字节。
指定的名称 pfSettingValue 需要在自定义设置点中是唯一的,因为 IDE 使用标识 GUID 的自定义设置点和的值 pfSettingValue 来标识每个保存的设置。
由于的值 pfSettingValue 必须是唯一的,因此,对接口的 ReadSettingBytes 其他方法调用方法的顺序 IVsSettingsReader 是不相关的。