IVsCfgProvider2.GetSupportedPlatformNames(UInt32, String[], UInt32[]) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает набор платформ, установленных на компьютере пользователя.
int GetSupportedPlatformNames(unsigned int celt, std::Array <std::wstring const &> const & rgbstr, std::Array <unsigned int> const & pcActual);
public int GetSupportedPlatformNames (uint celt, string[] rgbstr, uint[] pcActual);
abstract member GetSupportedPlatformNames : uint32 * string[] * uint32[] -> int
Public Function GetSupportedPlatformNames (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::GetSupportedPlatformNames(
[in] ULONG celt,
[in, out, size_is(celt)] BSTR rgbstr[],
[out, optional] ULONG *pcActual
);
Набор имен платформ, возвращаемых, GetSupportedPlatformNames — это платформы, которые можно добавить в проект. В конкретном проекте может использоваться одна или несколько установленных платформ. Например, для установки Visual C++ могут быть установлены платформы Win32 и Win64. Один проект может быть построен только для одной платформы, а другой проект — для обеих платформ.
Тип отдельного проекта определяет значение каждой платформы. Среда предоставляет пользовательский интерфейс, отображающий имена доступных платформ.
Как правило, выполняется два вызова GetSupportedPlatformNames . При первом вызове параметру присваивается значение celt 0, а — — rgbstr null pcActual допустимый адрес. GetSupportedPlatformNames Возвращает с pcActual указанием числа доступных имен поддерживаемых платформ. Вызывающая сторона использует эти сведения для выделения rgbstr соответствующего размера и вызова GetSupportedPlatformNames второго времени с параметром, равным celt содержимому pcActual .