FlavoredProject.IVsUIHierarchy.ParseCanonicalName(String, UInt32) Method

Reference

Definition

Namespace:: Microsoft.VisualStudio.Shell.Flavor

Assembly:: Microsoft.VisualStudio.Shell.14.0.dll

Assembly:: Microsoft.VisualStudio.Shell.15.0.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Returns the identifier of the hierarchy item, given its canonical name.

 virtual int Microsoft.VisualStudio.Shell.Interop.IVsUIHierarchy.ParseCanonicalName(System::String ^ pszName, [Runtime::InteropServices::Out] System::UInt32 % pitemid) = Microsoft::VisualStudio::Shell::Interop::IVsUIHierarchy::ParseCanonicalName;

int Microsoft.VisualStudio.Shell.Interop.IVsUIHierarchy.ParseCanonicalName(std::wstring const & pszName, [Runtime::InteropServices::Out] unsigned int & pitemid);

int IVsUIHierarchy.ParseCanonicalName (string pszName, out uint pitemid);

abstract member Microsoft.VisualStudio.Shell.Interop.IVsUIHierarchy.ParseCanonicalName : string * uint32 -> int
override this.Microsoft.VisualStudio.Shell.Interop.IVsUIHierarchy.ParseCanonicalName : string * uint32 -> int

Function ParseCanonicalName (pszName As String, ByRef pitemid As UInteger) As Integer Implements IVsUIHierarchy.ParseCanonicalName

Parameters

pszName: String

The canonical name of the item.

pitemid: UInt32

[out] The ID of the item.

Returns

Int32

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

Implements

ParseCanonicalName(String, UInt32)

Remarks

This method calls the ParseCanonicalName method, which calls the ParseCanonicalName method on the inner project.

Canonical names do not change between sessions of the environment, but item identifiers do. Use this method to manage workspace persistence, such as remembering window positions.

Applies to