IVsSettingsReader.ReadSettingBytes(String, Byte, Int32, Int32) Método

Definição

Retorna os valores de uma matriz armazenada no arquivo de configurações do 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

Parâmetros

pszSettingName
String

no Cadeia de caracteres que identifica exclusivamente o elemento de dados a ser recuperado.

pSettingValue
Byte

[entrada, saída] Buffer para receber dados de byte recuperados do elemento de dados especificado do arquivo de configurações do Visual Studio.

plDataLength
Int32

fora Número de valores de bytes retornados.

lDataMax
Int32

no Número máximo de bytes a serem retornados. Se o tamanho dos dados armazenados for maior que lDataMax , um erro será retornado.

Retornos

Int32

Se o método for bem-sucedido, retornará S_OK. Se falhar, retornará um código de erro.

Comentários

O valor de plDataLength deve ser sempre menor ou igual a lDataMax.

Qualquer buffer usado para receber os dados recuperados ( pSettingValue ) deve ter pelo menos lDataMax bytes de tamanho.

Os nomes especificados por pfSettingValue precisam ser exclusivos em um ponto de configurações personalizado, uma vez que o IDE usa o GUID de identificação do ponto de configurações personalizadas e o valor de pfSettingValue para identificar cada configuração salva.

Como o valor de pfSettingValue deve ser exclusivo, a ordem de chamar o ReadSettingBytes método em relação a outros métodos da IVsSettingsReader interface não é relevante.

Aplica-se a