Função SHGetAttributesFromDataObject (shlobj_core.h)
[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 |
---|---|
|
Êxito. |
|
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) |