Método IVsHasRelatedSaveItems.GetRelatedSaveTreeItems (VSSAVETREEITEM, UInt32, VSSAVETREEITEM , UInt32)

Artigo
04/23/2016

Obtém o número de itens relacionados, para salvar, ou retorna uma lista de itens relacionados para salvar.

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

Sintaxe

int GetRelatedSaveTreeItems(
    VSSAVETREEITEM saveItem,
    uint celt,
    VSSAVETREEITEM[] rgSaveTreeItems,
    out uint pcActual
)

int GetRelatedSaveTreeItems(
    VSSAVETREEITEM saveItem,
    unsigned int celt,
    array<VSSAVETREEITEM>^ rgSaveTreeItems,
    [OutAttribute] unsigned int% pcActual
)

abstract GetRelatedSaveTreeItems : 
        saveItem:VSSAVETREEITEM *
        celt:uint32 *
        rgSaveTreeItems:VSSAVETREEITEM[] *
        pcActual:uint32 byref -> int

Function GetRelatedSaveTreeItems (
    saveItem As VSSAVETREEITEM,
    celt As UInteger,
    rgSaveTreeItems As VSSAVETREEITEM(),
    <OutAttribute> ByRef pcActual As UInteger
) As Integer

Parâmetros

saveItem
[in] Ponteiro para uma VSSAVETREEITEM estrutura contendo informações sobre o item para procurar itens relacionados.

celt
[in] Zero ou o número de itens na rgSaveTreeItems.Consulte Comentários.

rgSaveTreeItems
[in, out] Ponteiro para uma matriz de VSSAVETREEITEM relacionados de estruturas que contêm informações sobre itens para economizar.

pcActual
[out] Ponteiro para um inteiro que é o número de itens relacionados, para salvar ou o número de elementos em rgSaveTreeItems.

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 vsshell80.idl:

HRESULT GetRelatedSaveTreeItems(
    [in] VSSAVETREEITEM saveItem,
    [in] ULONG celt,
    [in, out, size_is(celt)] VSSAVETREEITEM rgSaveTreeItems[],
    [out] ULONG *pcActual
);

Observações para Implementadores

O método pode retornar o número de relacionados salvar itens, ou ele pode retornar informações sobre o relacionados salvar itens.O método retorna o número de itens VSSAVETREEITEM em pcActual se celt é zero e pcActual não é null.

Observação
Se celt não é zero, rgSaveTreeItems não deve ser null.

Esse comportamento resulta em um padrão comum de encontrar o número de itens relacionados e, em seguida, recuperar informações sobre os itens, como no código a seguir.O código omite a verificação de erros para legibilidade.

hr = pIVsHasRelatedSaveItems->GetRelatedSaveTreeItems(saveItem, 
        0, NULL, &cExpected);
prgSaveTreeItems = ::CoTaskMemAlloc(
        cExpected * sizeof(VSSAVETREEITEM));
hr = pIVsHasRelatedSaveItems->GetRelatedSaveTreeItems(saveItem,
        cExpected, prgSaveTreeItems, &cActual);

Consulte também

Interface IVsHasRelatedSaveItems
Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao topo

Partilhar via