Função SHParseDisplayName (shlobj_core.h)

Converte o nome de exibição de um objeto de namespace shell em uma lista de identificadores de item e retorna os atributos do objeto. Essa função é o método preferencial para converter uma cadeia de caracteres em um ponteiro para uma PIDL (lista de identificadores de item).

Sintaxe

SHSTDAPI SHParseDisplayName(
  [in]            PCWSTR           pszName,
  [in, optional]  IBindCtx         *pbc,
  [out]           PIDLIST_ABSOLUTE *ppidl,
  [in]            SFGAOF           sfgaoIn,
  [out, optional] SFGAOF           *psfgaoOut
);

Parâmetros

[in] pszName

Tipo: LPCWSTR

Um ponteiro para uma cadeia de caracteres larga terminada em zero que contém o nome de exibição a ser analisado.

[in, optional] pbc

Tipo: IBindCtx*

Um contexto de associação que controla a operação de análise. Normalmente, esse parâmetro é definido como NULL.

[out] ppidl

Tipo: PIDLIST_ABSOLUTE*

O endereço de um ponteiro para uma variável do tipo ITEMIDLIST que recebe a lista de identificadores de item para o objeto. Se ocorrer um erro, esse parâmetro será definido como NULL.

[in] sfgaoIn

Tipo: SFGAOF

Um valor ULONG que especifica os atributos a serem consultados. Para consultar um ou mais atributos, inicialize esse parâmetro com os sinalizadores que representam os atributos de interesse. Para obter uma lista dos sinalizadores SFGAO disponíveis, consulte SFGAO.

[out, optional] psfgaoOut

Tipo: SFGAOF*

Um ponteiro para um ULONG. No retorno, os atributos que são verdadeiros para o objeto e foram solicitados em sfgaoIn são definidos. Os sinalizadores de atributo de um objeto podem ser zero ou uma combinação de sinalizadores SFGAO. Para obter uma lista dos sinalizadores SFGAO disponíveis, consulte SFGAO.

Retornar valor

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Você deve chamar essa função de um thread em segundo plano. Não fazer isso pode fazer com que a interface do usuário pare de responder.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shlobj_core.h (inclua Shlobj.h)
Biblioteca	Shell32.lib
DLL	Shell32.dll (versão 6.0 ou posterior)

Confira também

Ibindctx

IShellFolder::GetAttributesOf

IShellFolder::P arseDisplayName

ITEMIDLIST

SHGetPathFromIDList