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.
Возвращаемое значение
Если метод завершается успешно, возвращает значение S_OK. В противном случае функция возвращает код ошибки.
Комментарии
Используйте этот метод, чтобы определить идентификатор элемента (идентификатор элемента), учитывая каноническое имя элемента. Каноническое имя — это уникальное имя, используемое для различения конкретного элемента в иерархии от каждого другого элемента в иерархии. Используйте GetCanonicalName метод, чтобы определить каноническое имя по заданному идентификатору элемента.
Канонические имена не меняются между сеансами среды, но идентификаторы элементов имеют значение. Этот метод используется для управления сохраняемостью рабочей области, например для запоминания позиций окна.
Подпись COM
Из всшелл. IDL:
HRESULT IVsHierarchy::ParseCanonicalName(
[in] LPCOLESTR pszName,
[out] VSITEMID *pitemid
);