IVsRunningDocumentTable4.GetRelatedSaveTreeItems(UInt32, UInt32, UInt32, VSSAVETREEITEM[]) Метод

Определение

Извлекает связанные элементы дерева сохранения для документа.

public:
 System::UInt32 GetRelatedSaveTreeItems(System::UInt32 cookie, System::UInt32 grfSave, System::UInt32 celt, cli::array <Microsoft::VisualStudio::Shell::Interop::VSSAVETREEITEM> ^ rgSaveTreeItems);
unsigned int GetRelatedSaveTreeItems(unsigned int cookie, unsigned int grfSave, unsigned int celt, std::Array <Microsoft::VisualStudio::Shell::Interop::VSSAVETREEITEM> const & rgSaveTreeItems);
public uint GetRelatedSaveTreeItems (uint cookie, uint grfSave, uint celt, Microsoft.VisualStudio.Shell.Interop.VSSAVETREEITEM[] rgSaveTreeItems);
abstract member GetRelatedSaveTreeItems : uint32 * uint32 * uint32 * Microsoft.VisualStudio.Shell.Interop.VSSAVETREEITEM[] -> uint32
Public Function GetRelatedSaveTreeItems (cookie As UInteger, grfSave As UInteger, celt As UInteger, rgSaveTreeItems As VSSAVETREEITEM()) As UInteger

Параметры

cookie
UInt32

[in] Документ, из которого необходимо получить связанные элементы дерева сохранения.

grfSave
UInt32

[in] Параметры сохранения для документа в таблице выполняющихся документов (RDT).

celt
UInt32

[in] Размер связанных элементов дерева сохранения.

rgSaveTreeItems
VSSAVETREEITEM[]

[out, size_is(celt), length_is(*pcActual)] Массив, содержащий параметры сохранения для элемента представления дерева.

Возвращаемое значение

UInt32

Фактическое количество связанных элементов дерева сохранения, которое было получено.

Реализации

Комментарии

Если celt равно нулю и возвращаемое значение не равно null, то число VSSAVETREEITEM возвращается в возвращаемом значении. Если значение не celt равно нулю, rgSaveTreeItems не должно иметь значение null.

В следующем примере показан распространенный способ использования этого метода (при этом проверка ошибок для удобочитаемости отсутствует):

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

Применяется к