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) |