Método IVsHierarchy.ParseCanonicalName (String, UInt32)

Artigo
08/03/2016

Publicado: abril de 2016

Retorna o identificador do item de hierarquia, dado seu nome canônico.

Namespace: Microsoft.VisualStudio.Shell.Interop
Assembly: Microsoft.VisualStudio.Shell.Interop (em Microsoft.VisualStudio.Shell.Interop.dll)

Sintaxe

int ParseCanonicalName(
    string pszName,
    out uint pitemid
)

int ParseCanonicalName(
    String^ pszName,
    [OutAttribute] unsigned int% pitemid
)

abstract ParseCanonicalName : 
        pszName:string *
        pitemid:uint32 byref -> int

Function ParseCanonicalName (
    pszName As String,
    <OutAttribute> ByRef pitemid As UInteger
) As Integer

Parâmetros

pszName
[in] Ponteiro para o nome canônico de um item de hierarquia.

pitemid
[out] Ponteiro para o identificador de item para o item de hierarquia.Para obter uma lista de pitemid valores, consulte VSITEMID.

Valor de retorno

Type: System.Int32

Se o método for bem-sucedido, ele retorna S_OK.Se ele falhar, ele retorna um código de erro.

Comentários

Use esse método para determinar um identificador de item (item ID), receberá o nome canônico para 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 recebe uma ID de item.

Nomes canônicos não alteram entre sessões do ambiente, mas fazem de identificadores de item.Use esse método para gerenciar a persistência de espaço de trabalho, como, por exemplo, lembrando a posição das janelas.

COM assinatura

De vsshell.idl:

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

Consulte também

Interface IVsHierarchy
Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao topo

Compartilhar via