Método IVsSccProject2.GetSccFiles (UInt32, CALPOLESTR[], CADWORD )

Artigo
04/23/2016

Este método é chamado para determinar quais arquivos devem ser colocados sob o controle de origem para um determinado VSITEMID dentro dessa hierarquia.

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

Sintaxe

int GetSccFiles(
    uint itemid,
    CALPOLESTR[] pCaStringsOut,
    CADWORD[] pCaFlagsOut
)

int GetSccFiles(
    unsigned int itemid,
    array<CALPOLESTR>^ pCaStringsOut,
    array<CADWORD>^ pCaFlagsOut
)

abstract GetSccFiles : 
        itemid:uint32 *
        pCaStringsOut:CALPOLESTR[] *
        pCaFlagsOut:CADWORD[] -> int

Function GetSccFiles (
    itemid As UInteger,
    pCaStringsOut As CALPOLESTR(),
    pCaFlagsOut As CADWORD()
) As Integer

Parâmetros

itemid
[in] Identificador para o VSITEMID que está sendo consultado.

pCaStringsOut
[out] Ponteiro para uma matriz de CALPOLESTR seqüências de caracteres que contém os nomes de arquivo para este item.

pCaFlagsOut
[out] Ponteiro para uma CADWORD matriz de sinalizadores são armazenados em DWORDs que indicam que alguns dos arquivos tem comportamentos especiais.

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.

Observação
Se um projeto retorna E_NOTIMPL, GetMkDocument será chamado para descobrir o arquivo associado ao nó.Se cada um de nós do projeto se refere a um único arquivo e não existem arquivos especiais, um projeto pode retornar com segurança sempre E_NOTIMPL.

Comentários

COM assinatura

De ivssccproject2.idl

HRESULT GetSccFiles(
   [in] VSITEMID itemid,
   [out] CALPOLESTR *pCaStringsOut,
   [out] CADWORD *pCaFlagsOut
);

Se você usar GetMkDocument, os sinalizadores são assumidos como zero.Se pCaFlagsOut->cElems tem zero elementos, os sinalizadores são assumidos como zero.Se você não tiver todos os arquivos sob controle de origem, os arquivos de zero devem ser retornados porque GetSccFiles não existe nenhum outro propósito.

Se o sinalizador SFF_HasSpecialFiles está definido para qualquer um dos arquivos associados com o nó, GetSccSpecialFiles será chamado para esses arquivos.

Os sinalizadores de arquivos de origem (SFF) têm duas configurações:

SFF_NoFlags= 0 indica que não há nenhum arquivo especial associado ao nó.
SFF_HasSpecialFiles= 1 (ou diferente de zero) indica que há arquivos especiais associados ao nó.

Arquivos especiais são arquivos ocultos que fundamentam os arquivos normais visíveis na Solution Explorer e de Check-In e Check-Out caixas de diálogo.

Consulte também

Interface IVsSccProject2
Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao topo

Partilhar via