IVsRunningDocumentTable.GetDocumentInfo Method

Definition

Returns information about a document registered in the RDT, given the cookie.

C++
public:
 int GetDocumentInfo(System::UInt32 docCookie, [Runtime::InteropServices::Out] System::UInt32 % pgrfRDTFlags, [Runtime::InteropServices::Out] System::UInt32 % pdwReadLocks, [Runtime::InteropServices::Out] System::UInt32 % pdwEditLocks, [Runtime::InteropServices::Out] System::String ^ % pbstrMkDocument, [Runtime::InteropServices::Out] Microsoft::VisualStudio::Shell::Interop::IVsHierarchy ^ % ppHier, [Runtime::InteropServices::Out] System::UInt32 % pitemid, [Runtime::InteropServices::Out] IntPtr % ppunkDocData);

Parameters

docCookie
UInt32

[in] Abstract value representing the document for which information was requested.

pgrfRDTFlags
UInt32

[out] Returns flags whose values are taken from the _VSRDTFLAGS enumeration.

pdwReadLocks
UInt32

[out] Returns the number of read locks on the document.

pdwEditLocks
UInt32

[out] Returns the number of edit locks on the document.

pbstrMkDocument
String

[out] Returns the path and file name of the document.

ppHier
IVsHierarchy

[out, optional] Returns the IVsHierarchy interface.

pitemid
UInt32

[out, optional] Item identifier of the document. This is a unique identifier or it can be one of the following values: VSITEMID_NIL, VSITEMID_ROOT, or VSITEMID_SELECTION.

ppunkDocData
IntPtr

[out, optional] Returns an IUnknown interface.

Returns

If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Remarks

This method must be accessed on the main thread.

Applies to

Produit Versions
Visual Studio SDK 2015, 2017, 2019, 2022