Método IShellFolder::GetAttributesOf (shobjidl_core.h)
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) |