Função AssocGetDetailsOfPropKey (shlobj_core.h)

Recupera o valor de uma determinada chave de propriedade usando as informações de associação de arquivo fornecidas pelas Extensões do 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 de shell para a qual os detalhes da chave de propriedade da associação de arquivos 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 é retornada, contém os detalhes da chave de propriedade fornecida.

[out] pfFoundPropKey

Tipo: BOOL*

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

Valor de retorno

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT .

Observações

Essa função deve ser usada somente 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 fornecidas 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 arquivos para pastas (ASSOCCLASS_FOLDER) para recuperar o valor da chave de propriedade.

• 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

Requirements