IVsHierarchy.ParseCanonicalName(String, UInt32) Methode

Definition

Gibt den Bezeichner des Hierarchienelements anhand des kanonischen Namens zurück.

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

Parameter

pszName
String

[in] Zeiger auf den kanonischen Namen des Hierarchieelements.

pitemid
UInt32

[out] Zeiger auf den Elementbezeichner für das Hierarchienelement. Eine Liste der pitemid-Werte finden Sie unter VSITEMID.

Gibt zurück

Int32

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Bei einem Fehler wird ein Fehlercode zurückgegeben.

Hinweise

Verwenden Sie diese Methode, um einen Element Bezeichner (Element-ID) zu bestimmen, wobei der kanonische Name für ein Element angegeben wird. Der kanonische Name ist ein eindeutiger Name, der zum unterscheiden eines bestimmten Elements in der Hierarchie von allen anderen Elementen in der Hierarchie verwendet wird. Verwenden Sie die- GetCanonicalName Methode, um den kanonischen Namen für eine Element-ID zu bestimmen.

Kanonische Namen ändern sich nicht zwischen Sitzungen der Umgebung, aber Element Bezeichner. Verwenden Sie diese Methode, um die Arbeitsbereichs Persistenz zu verwalten, z. b. die Position

COM-Signatur

Aus vsshell. idl:

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

Gilt für