Compartilhar via

Método IShellFolder2::GetDetailsOf (shobjidl_core.h)

  • Artigo

Obtém informações detalhadas, identificadas por um índice de coluna, em um item em uma pasta shell.

Sintaxe

HRESULT GetDetailsOf(
  [in]  PCUITEMID_CHILD pidl,
  [in]  UINT            iColumn,
  [out] SHELLDETAILS    *psd
);

Parâmetros

[in] pidl

Tipo: PCUITEMID_CHILD

PIDL do item para o qual você está solicitando informações. Esse método aceita apenas PIDLs de nível único. A estrutura deve conter exatamente uma estrutura SHITEMID seguida por um zero de terminação. Se esse parâmetro for definido como NULL, o título do campo de informações especificado por iColumn será retornado.

[in] iColumn

Tipo: UINT

O índice baseado em zero do campo de informações desejado. Ela é idêntica ao número da coluna das informações, pois elas são exibidas em um modo de exibição Detalhes do Windows Explorer.

[out] psd

Tipo: SHELLDETAILS*

Um ponteiro para uma estrutura SHELLDETAILS que contém as informações.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

O método IShellFolder2::GetDetailsOf é idêntico a GetDetailsOf. Para obter uma maneira mais robusta de recuperar informações de item que não exigem que você conheça o índice de coluna, use IShellFolder2::GetDetailsEx.

O método IShellFolder2::GetDetailsOf fornece acesso às informações exibidas na exibição Detalhes do Explorer do Windows de uma pasta shell. Os números de coluna, títulos e informações que você vê na exibição Detalhes são idênticos aos de IShellFolder2::GetDetailsOf. Observe que os campos de informações disponíveis e seus números de coluna variam dependendo da pasta específica. Você pode enumerar os campos disponíveis chamando esse método com pidl definido como NULL e examinando o título associado a cada índice de coluna. Tenha em mente que esses títulos podem ser localizados e podem não ser os mesmos para todas as localidades.

As pastas do sistema de arquivos têm um conjunto grande e padrão de campos de informações. Os quatro primeiros campos são padrão para todas as pastas do sistema de arquivos.

Índice da coluna Título da coluna
0 Nome
1 Tamanho
2 Tipo
3 Data da Modificação
 

As pastas do sistema de arquivos podem dar suporte a vários campos adicionais. No entanto, eles não são necessários para fazer isso, e os índices de coluna atribuídos a esses campos podem variar.

Cada pasta virtual tem seu próprio conjunto exclusivo de campos de informações. Normalmente, o nome de exibição do item está na coluna zero, mas a ordem e o conteúdo dos campos restantes dependem da implementação do objeto de pasta específico.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional, 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 shobjidl_core.h (inclua Shobjidl.h)
DLL Shell32.dll (versão 5.0 ou posterior)