IVsCfgProvider2.GetSupportedPlatformNames(UInt32, String[], UInt32[]) 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 o conjunto de plataformas que estão instaladas no computador do usuário.
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
Parâmetros
- celt
- UInt32
no Especifica o número solicitado de nomes de plataforma com suporte. Se esse número for desconhecido, celt poderá ser zero.
- rgbstr
- String[]
[in, out, size_is (celt)] Na entrada, uma matriz alocada para armazenar o número de nomes especificados por celt. esse parâmetro também pode ser null se o celt parâmetro for zero. Na saída, rgbstr contém os nomes das plataformas com suporte.
- pcActual
- UInt32[]
[saída, opcional] Ponteiro para uma contagem do número real de nomes de plataforma retornados.
Retornos
Se o método for bem-sucedido, retornará S_OK. Se falhar, retornará um código de erro.
Comentários
Assinatura COM
De VSShell. idl:
HRESULT IVsCfgProvider2::GetSupportedPlatformNames(
[in] ULONG celt,
[in, out, size_is(celt)] BSTR rgbstr[],
[out, optional] ULONG *pcActual
);
O conjunto de nomes de plataforma retornado pelo GetSupportedPlatformNames são as plataformas que podem ser adicionadas a um projeto. Um projeto específico pode usar uma ou mais das plataformas instaladas. Por exemplo, é possível ter as plataformas Win32 e Win64 para Visual C++ instaladas. Um projeto pode ser criado para apenas uma das plataformas, enquanto outro projeto pode ser criado para ambas as plataformas.
Um tipo de projeto individual especifica o significado de cada plataforma. O ambiente fornece a interface do usuário que exibe os nomes das plataformas disponíveis.
Normalmente, são feitas duas chamadas para GetSupportedPlatformNames . Com a primeira chamada, celt é definido como zero, rgbstr to null e pcActual como um endereço válido. GetSupportedPlatformNames retorna ao pcActual apontar para o número de nomes de plataforma com suporte disponíveis. O chamador usa essas informações para alocar rgbstr o tamanho apropriado e chamar GetSupportedPlatformNames uma segunda vez com celt definido como o conteúdo de pcActual .