IVsHierarchy.ParseCanonicalName(String, UInt32) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Retorna o identificador do item de hierarquia, dado seu nome canônico.
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
Parâmetros
- pszName
- String
no Ponteiro para o nome canônico do item de hierarquia.
- pitemid
- UInt32
fora Ponteiro para o identificador de item do item de hierarquia. Para obter uma lista de pitemid valores, consulte VSITEMID .
Retornos
Se o método for bem-sucedido, retornará S_OK. Se falhar, retornará um código de erro.
Comentários
Use este método para determinar um identificador de item (ID do item), dado o nome canônico de um item. O nome canônico é um nome exclusivo usado para distinguir um item específico na hierarquia de todos os outros itens na hierarquia. Use o GetCanonicalName método para determinar o nome canônico dado uma ID de item.
Os nomes canônicos não são alterados entre as sessões do ambiente, mas os identificadores de item. Use esse método para gerenciar a persistência do espaço de trabalho, como memorizar as posições da janela.
Assinatura COM
De VSShell. idl:
HRESULT IVsHierarchy::ParseCanonicalName(
[in] LPCOLESTR pszName,
[out] VSITEMID *pitemid
);