Compartilhar via

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

  • Artigo

Obtém informações detalhadas, identificadas por um FMTID (identificador de conjunto de propriedades) e um PID (identificador de propriedade), em um item em uma pasta shell.

Sintaxe

HRESULT GetDetailsEx(
  [in]  PCUITEMID_CHILD  pidl,
  [in]  const SHCOLUMNID *pscid,
  [out] VARIANT          *pv
);

Parâmetros

[in] pidl

Tipo: PCUITEMID_CHILD

Um PIDL do item, em relação à pasta pai. 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. Esse valor não pode ser NULL.

[in] pscid

Tipo: const SHCOLUMNID*

Um ponteiro para uma estrutura SHCOLUMNID que identifica a coluna.

[out] pv

Tipo: VARIANT*

Um ponteiro para um VARIANT com as informações solicitadas. O valor é totalmente tipado. O valor retornado para propriedades do sistema de propriedades deve estar em conformidade com o tipo especificado no typeInfo dessa definição de propriedade como o atributo legacyType .

Valor retornado

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

Essa função é uma versão mais robusta de IShellFolder2::GetDetailsOf. Ele fornece acesso às informações exibidas na exibição Detalhes do Windows Explorer de uma pasta shell. A principal diferença é que GetDetailsEx permite que você identifique a coluna com uma estrutura FMTID e PID em vez de precisar primeiro determinar o índice da coluna.

Requisitos

   
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)