IVsSettingsReader.ReadSettingBytes(String, Byte, Int32, Int32) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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.