IVsCfgProvider2.GetCfgNames(UInt32, String[], UInt32[]) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает одно или несколько имен конфигурации.
int GetCfgNames(unsigned int celt, std::Array <std::wstring const &> const & rgbstr, std::Array <unsigned int> const & pcActual);
public int GetCfgNames (uint celt, string[] rgbstr, uint[] pcActual);
abstract member GetCfgNames : uint32 * string[] * uint32[] -> int
Public Function GetCfgNames (celt As UInteger, rgbstr As String(), Optional pcActual As UInteger()) As Integer
Параметры
- celt
- UInt32
[in] Указывает запрошенное число имен свойств. Если это число неизвестно, оно celt может равняться нулю.
- rgbstr
- String[]
[in, out, size_is (celt)] На входе — выделенный массив для хранения количества имен свойств конфигурации, заданных параметром celt . Этот параметр также может иметь значение, null Если celt параметр равен нулю. На выходе rgbstr содержит имена свойств конфигурации.
- pcActual
- UInt32[]
[out, optional] Указатель на счетчик фактического числа возвращенных имен свойств.
Возвращаемое значение
Если метод завершается успешно, возвращает значение S_OK. В противном случае функция возвращает код ошибки.
Комментарии
Подпись COM
Из всшелл. IDL:
HRESULT IVsCfgProvider2::GetCfgNames(
[in] ULONG celt,
[in, out, size_is(celt)] BSTR rgbstr[],
[out, optional] ULONG *pcActual
);
Обычно выполняется два вызова GetCfgNames . При первом вызове параметру присваивается значение celt 0, а — — rgbstr null pcActual допустимый адрес. GetCfgNames Возвращает с pcActual указанием количества доступных имен свойств. Вызывающая сторона использует эти сведения для выделения rgbstr соответствующего размера и вызова GetCfgNames второго времени с параметром, равным celt содержимому pcActual .