Função SHGetAttributesFromDataObject (shlobj_core.h)

  • Artigo

[SHGetAttributesFromDataObject está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]

Recupera informações especificadas de um objeto de dados do sistema.

Sintaxe

HRESULT SHGetAttributesFromDataObject(
  [in, optional]  IDataObject *pdo,
                  DWORD       dwAttributeMask,
  [out, optional] DWORD       *pdwAttributes,
  [out, optional] UINT        *pcItems
);

Parâmetros

[in, optional] pdo

Tipo: IDataObject*

O objeto de dados do qual recuperar as informações.

dwAttributeMask

Tipo: DWORD

Um ou mais dos sinalizadores SFGAO que indicam quais informações o aplicativo de chamada deseja recuperar.

[out, optional] pdwAttributes

Tipo: DWORD*

Um ponteiro para um valor DWORD que, quando essa função retorna com êxito, recebe um ou mais sinalizadores SFGAO que indicam os atributos, entre os solicitados, que são comuns a todos os itens no pdo. Esse ponteiro poderá ser NULL se essas informações não forem necessárias.

[out, optional] pcItems

Tipo: UINT*

Um ponteiro para um UINT que, quando essa função retorna com êxito, recebe o número de PIDLs no objeto de dados apontado pelo pdo. Esse ponteiro poderá ser NULL se essas informações não forem necessárias.

Retornar valor

Tipo: HRESULT

Essa função pode retornar um desses valores.

Código de retorno Descrição
S_OK
 Êxito.
S_FALSE
 O objeto não é um objeto de dados do sistema. Nesse caso, pdwAttributes é definido como 0.

Requisitos

Requisito Valor
Cliente mínimo com suporte 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 shlobj_core.h (inclua Shlobj.h)
Biblioteca Shell32.lib
DLL Shell32.dll (versão 6.0 ou posterior)