IVsHierarchy.ParseCanonicalName(String, UInt32) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
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
);