Método IVsCfgProvider2.GetCfgNames (UInt32, String[], UInt32 )

Artigo
08/03/2016

Publicado: abril de 2016

Retorna um ou mais nomes de configuração.

Namespace: Microsoft.VisualStudio.Shell.Interop
Assembly: Microsoft.VisualStudio.Shell.Interop (em Microsoft.VisualStudio.Shell.Interop.dll)

Sintaxe

int GetCfgNames(
    uint celt,
    string[] rgbstr,
    uint[] pcActual
)

int GetCfgNames(
    unsigned int celt,
    array<String^>^ rgbstr,
    array<unsigned int>^ pcActual
)

abstract GetCfgNames : 
        celt:uint32 *
        rgbstr:string[] *
        pcActual:uint32[] -> int

Function GetCfgNames (
    celt As UInteger,
    rgbstr As String(),
    pcActual As UInteger()
) As Integer

Parâmetros

celt
[in] Especifica o número solicitado de nomes de propriedades.Se esse número for desconhecido, celt pode ser zero.

rgbstr
[in, out, size_is(celt)] Diante de entrada, uma matriz alocada para manter o número de nomes de propriedades de configuração especificado por celt.Este parâmetro também pode ser null se a celt parâmetro é zero.Na saída, rgbstr contém os nomes de propriedades de configuração.

pcActual
[out, opcional] Ponteiro para uma contagem do número real de nomes de propriedades retornado.

Valor de retorno

Type: System.Int32

Se o método for bem-sucedido, ele retorna S_OK.Se ele falhar, ele retorna um código de erro.

Comentários

COM assinatura

De vsshell.idl:

HRESULT IVsCfgProvider2::GetCfgNames(
   [in] ULONG celt,
   [in, out, size_is(celt)] BSTR rgbstr[],
   [out, optional] ULONG *pcActual
);

Normalmente, duas chamadas são feitas para GetCfgNames.Com a primeira chamada, celt é definida como zero, rgbstr para null, e pcActual para um endereço válido.GetCfgNamesRetorna com pcActual apontando para o número de nomes de propriedades disponíveis.O chamador usa essas informações para alocar rgbstr para o tamanho apropriado e a chamada GetCfgNames uma segunda vez com celt definido como o conteúdo de pcActual.

Consulte também

Interface IVsCfgProvider2
Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao topo

Compartilhar via