IVsCfgProvider2.GetCfgNames(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 um ou mais nomes de configuração.
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
Parâmetros
- celt
- UInt32
no Especifica o número solicitado de nomes de propriedade. 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 de propriedade de configuração especificados por celt . Esse parâmetro também pode ser null se o celt parâmetro for zero. Na saída, rgbstr contém nomes de propriedade de configuração.
- pcActual
- UInt32[]
[saída, opcional] Ponteiro para uma contagem do número real de nomes de propriedade 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::GetCfgNames(
[in] ULONG celt,
[in, out, size_is(celt)] BSTR rgbstr[],
[out, optional] ULONG *pcActual
);
Normalmente, são feitas duas chamadas para GetCfgNames . Com a primeira chamada, celt é definido como zero, rgbstr to null e pcActual como um endereço válido. GetCfgNames retorna ao pcActual apontar para o número de nomes de propriedade disponíveis. O chamador usa essas informações para alocar rgbstr o tamanho apropriado e chamar GetCfgNames uma segunda vez com celt definido como o conteúdo de pcActual .