IVsHierarchy.ParseCanonicalName(String, UInt32) Метод

Определение

Возвращает идентификатор элемента иерархии, заданного его каноническим именем.

public:
 int ParseCanonicalName(System::String ^ pszName, [Runtime::InteropServices::Out] System::UInt32 % pitemid);
int ParseCanonicalName(std::wstring const & pszName, [Runtime::InteropServices::Out] unsigned int & pitemid);
public int ParseCanonicalName (string pszName, out uint pitemid);
abstract member ParseCanonicalName : string * uint32 -> int
Public Function ParseCanonicalName (pszName As String, ByRef pitemid As UInteger) As Integer

Параметры

pszName
String

[in] Указатель на каноническое имя элемента иерархии.

pitemid
UInt32

[out] Указатель на идентификатор элемента для элемента иерархии. Список значений pitemid см. в VSITEMID.

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

Int32

Если метод завершается успешно, возвращает значение S_OK. В противном случае функция возвращает код ошибки.

Комментарии

Используйте этот метод, чтобы определить идентификатор элемента (идентификатор элемента), учитывая каноническое имя элемента. Каноническое имя — это уникальное имя, используемое для различения конкретного элемента в иерархии от каждого другого элемента в иерархии. Используйте GetCanonicalName метод, чтобы определить каноническое имя по заданному идентификатору элемента.

Канонические имена не меняются между сеансами среды, но идентификаторы элементов имеют значение. Этот метод используется для управления сохраняемостью рабочей области, например для запоминания позиций окна.

Подпись COM

Из всшелл. IDL:

HRESULT IVsHierarchy::ParseCanonicalName(  
   [in] LPCOLESTR pszName,  
   [out] VSITEMID *pitemid  
);  

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