Função SHGetRealIDL (shlobj_core.h)

Artigo
03/05/2024

[SHGetRealIDL está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]

Converte um ponteiro simples em uma lista de identificadores de item (PIDL) em um PIDL completo.

Sintaxe

SHSTDAPI SHGetRealIDL(
  [in]  IShellFolder    *psf,
  [in]  PCUITEMID_CHILD pidlSimple,
  [out] PITEMID_CHILD   *ppidlReal
);

Parâmetros

[in] psf

Tipo: IShellFolder*

Um ponteiro para uma instância do IShellFolder cujo PIDL simples deve ser convertido.

[in] pidlSimple

Tipo: PCUITEMID_CHILD

O PIDL simples a ser convertido.

[out] ppidlReal

Tipo: PITEMID_CHILD*

Quando esse método retorna, contém um ponteiro para o PIDL convertido completo. Se a função falhar, esse parâmetro será definido como NULL.

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.

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 5.0 ou posterior)
Conjunto de APIs	ext-ms-win-shell32-l1-2-2 (introduzido no Windows 10, versão 10.0.14393)