Método IShellFolder::GetAttributesOf (shobjidl_core.h)

  • Artigo

Obtém os atributos de um ou mais objetos de arquivo ou pasta contidos no objeto representado por IShellFolder.

Sintaxe

HRESULT GetAttributesOf(
  [in]      UINT                  cidl,
  [in]      PCUITEMID_CHILD_ARRAY apidl,
  [in, out] SFGAOF                *rgfInOut
);

Parâmetros

[in] cidl

Tipo: UINT

O número de itens dos quais recuperar atributos.

[in] apidl

Tipo: PCUITEMID_CHILD_ARRAY*

O endereço de uma matriz de ponteiros para estruturas ITEMIDLIST , cada uma das quais identifica exclusivamente um item em relação à pasta pai. Cada estrutura ITEMIDLIST deve conter exatamente uma estrutura SHITEMID seguida por um zero de terminação.

[in, out] rgfInOut

Tipo: SFGAOF*

Ponteiro para um único valor ULONG que, na entrada, contém os atributos SFGAO bit a bit que o aplicativo de chamada está solicitando. Na saída, esse valor contém os atributos solicitados que são comuns a todos os itens especificados.

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

Para otimizar essa operação, não retorne sinalizadores não especificados.

Para um objeto folder, o atributo SFGAO_BROWSABLE implica que o cliente pode se associar a esse objeto, conforme mostrado em um formulário geral aqui.

IShellFolder::BindToObject(..., pidl, IID_IShellFolder, &psfItem);

Em seguida, o cliente pode criar um IShellView nesse item por meio dessa instrução.

psfItem->CreateViewObject(..., IID_IShellView,...);

O atributo SFGAO_DROPTARGET implica que o cliente pode se associar a uma instância do IDropTarget para essa pasta chamando IShellFolder::GetUIObjectOf , conforme mostrado aqui.

IShellFolder::GetUIObjectOf(hwnd, 1, &pidl, IID_IDropTarget, NULL, &pv)

O atributo SFGAO_NONENUMERATED indica um item que não é retornado pelo enumerador criado pelo método IShellFolder::EnumObjects .

Requisitos

   
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shobjidl_core.h (inclua Shobjidl.h)
DLL Shell32.dll (versão 4.0 ou posterior)

Confira também

Ishellfolder

IShellFolder2