Função AssocGetDetailsOfPropKey (shlobj_core.h)

  • Artigo

Recupera o valor de uma determinada chave de propriedade usando as informações de associação de arquivo fornecidas pelas Extensões de Namespace.

Sintaxe

SHSTDAPI AssocGetDetailsOfPropKey(
  [in]  IShellFolder      *psf,
  [in]  PCUITEMID_CHILD   pidl,
  [in]  const PROPERTYKEY *pkey,
  [out] VARIANT           *pv,
  [out] BOOL              *pfFoundPropKey
);

Parâmetros

[in] psf

Tipo: IShellFolder*

Um ponteiro para a pasta do shell para a qual os detalhes da chave de propriedade da associação de arquivo estão sendo recuperados.

[in] pidl

Tipo: PCUITEMID_CHILD

O PIDL do item filho para o qual as associações de arquivo estão sendo solicitadas.

[in] pkey

Tipo: PROPERTYKEY*

Um ponteiro para a chave de propriedade que está sendo recuperada.

[out] pv

Tipo: VARIANT*

Quando essa função retorna, contém os detalhes da chave de propriedade fornecida.

[out] pfFoundPropKey

Tipo: BOOL*

Quando essa função retorna, contém um sinalizador true se a chave de propriedade foi encontrada; caso contrário, FALSE.

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

Essa função deve ser usada apenas por implementadores de Extensões de NamespaceIShellFolder. Outros aplicativos de chamada devem usar IShellFolder2::GetDetailsEx para obter um valor para um PROPERTYKEY. Essa função deve ser usada por implementadores de Extensões de Namespace IShellFolder .

A extensão de namespace fornecida deve dar suporte ao uso dessa API de uma das três maneiras a seguir.

  1. Se as Extensões de Namespace fornecidas derem suporte à recuperação de uma interface IQueryAssociations para o item implementando IShellFolder::GetUIObjectOf(..., IID_IQueryAssociations, ...), AssocGetDetailsOfPropKey usará a API de associações de arquivo fornecida para recuperar o valor da chave de propriedade.
  2. Se a extensão de namespace fornecida retornar SFGAO_FILESYSTEM para o item de IShellFolder::GetAttributesOf e fornecer um nome de análise para o item, AssocGetDetailsOfPropKey usará as associações padrão do sistema de arquivos para recuperar o valor da chave de propriedade.
  3. Se a extensão de namespace fornecida retornar SFGAO_FOLDER | SFGAO_BROWSABLE para o item de IShellFolder::GetAttributesOf, AssocGetDetailsOfPropKey usará a associação de arquivo para pastas (ASSOCCLASS_FOLDER) para recuperar o valor da chave de propriedade.
Se o ShellFolder que está sendo implementado contiver itens extensíveis por meio do mecanismo de associações de arquivo, você poderá usar essa função para recuperar PropertyKeys declarados para uma determinada associação de arquivo. Por exemplo, se uma determinada pasta shell conduz um painel de detalhes e você deseja que as propriedades exibidas nesse painel sejam regidas por extensões de nome de arquivo de terceiros, você pode usar essa função para retornar PKEY_PropList_PreviewDetails. Essa chave tem um valor declarado no Registro para essa extensão de nome de arquivo com uma lista delimitada por ponto e vírgula de propriedades. Há uma lista de propriedades definidas pela extensão de nome de arquivo no Registro. Essa lista inclui, mas não se limita ao seguinte:
  • PKEY_PropList_PreviewDetails
  • PKEY_PropList_PreviewTitle
  • PKEY_PropList_FullDetails
  • PKEY_PropList_TileInfo
  • PKEY_PropList_ExtendedTileInfo
  • PKEY_PropList_InfoTip
  • PKEY_PropList_QuickTip
  • PKEY_PropList_FileOperationPrompt
  • PKEY_PropList_ConflictPrompt
  • PKEY_PropList_SetDefaultsFor
  • PKEY_PropList_NonPersonal
  • PKEY_NewMenuPreferredTypes
  • PKEY_NewMenuAllowedTypes

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shlobj_core.h (inclua Shlobj.h)
DLL Shell32.dll