IVsRunningDocumentTable4.GetRelatedSaveTreeItems(UInt32, UInt32, UInt32, VSSAVETREEITEM[]) Methode

Definition

Ruft die verknüpften Speicherstrukturelemente für ein Dokument ab.

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

Parameter

cookie
UInt32

[in] Dokument, aus dem die zugehörigen Speicherstrukturelemente abgerufen werden.

grfSave
UInt32

[in] Speicheroptionen für das Dokument in der Tabelle aktiver Dokumente (RDT).

celt
UInt32

[in] Größe der zugehörigen Strukturelemente zum Speichern.

rgSaveTreeItems
VSSAVETREEITEM[]

[out, size_is(celt), length_is(*pcActual)] Array, das die Speicheroptionen für das Strukturansichtselement enthält.

Gibt zurück

UInt32

Die tatsächliche Anzahl der in Verbindung stehenden Strukturspeicherungselemente, die abgerufen wurden.

Implementiert

Hinweise

Wenn celt 0 (null) ist und der Rückgabewert nicht NULL ist, wird die Anzahl von VSSAVETREEITEM im Rückgabewert zurückgegeben. Wenn celt nicht 0 (null) ist, rgSaveTreeItems darf nicht NULL sein.

Das folgende Beispiel zeigt eine gängige Methode der Verwendung dieser Methode (auslassen von Fehlerüberprüfungen zur besseren Lesbarkeit):

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

Gilt für