Método IShellDetails::GetDetailsOf (shlobj_core.h)

Obtém informações detalhadas sobre um item em uma pasta shell.

Sintaxe

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

Parâmetros

[in, optional] pidl

Tipo: PCUITEMID_CHILD

O PIDL do item para o qual você está solicitando informações. Se esse parâmetro for definido como NULL, o título do campo de informações especificado por iColumn será retornado na estrutura SHELLDETAILS apontada por pDetails.

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] pDetails

Tipo: SHELLDETAILS*

Um ponteiro para uma estrutura SHELLDETAILS com as informações detalhadas.

Retornar valor

Tipo: HRESULT

Retorna S_OK se tiver êxito. Retorna E_FAIL se iColumn exceder o número de colunas compatíveis com a pasta . Caso contrário, retornará um código de erro COM padrão.

Comentários

Esse método foi substituído pelos métodos IShellFolder2 para Shell versão 5.0 e posterior.

O método IShellDetails::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 de coluna e informações de item que você vê na exibição Detalhes são idênticos aos retornados por IShellDetails::GetDetailsOf.

Os campos de informações disponíveis e seus números de coluna variam dependendo da pasta específica. Para enumerar os campos disponíveis, chame IShellDetails::GetDetailsOf com pidl definido como NULL para aumentar os valores de iColumn. Essa abordagem fornece o título associado a cada índice de coluna. Quando iColumn exceder o número de colunas compatíveis com a pasta, IShellDetails::GetDetailsOf retornará E_FAIL. Tenha em mente que esses títulos são localizáveis e podem não ser os mesmos para todas as localidades.

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

Índice de 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 disponíveis dependem da implementação do objeto de pasta específico.

Observação aos implementadores

Os objetos folder devem implementar IShellFolder2 em vez dessa interface.

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
DLL	Shell32.dll (versão 5.0 ou posterior)