SHGetAttributesFromDataObject function (shlobj_core.h)

[SHGetAttributesFromDataObject is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

Retrieves specified pieces of information from a system data object.

Syntax

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

Parameters

[in, optional] pdo

Type: IDataObject*

The data object from which to retrieve the information.

dwAttributeMask

Type: DWORD

One or more of the SFGAO flags that indicate which pieces of information the calling application wants to retrieve.

[out, optional] pdwAttributes

Type: DWORD*

A pointer to a DWORD value that, when this function returns successfully, receives one or more SFGAO flags that indicate the attributes, among those requested, that are common to all items in pdo. This pointer can be NULL if this information is not needed.

[out, optional] pcItems

Type: UINT*

A pointer to a UINT that, when this function returns successfully, receives the number of PIDLs in the data object pointed to by pdo. This pointer can be NULL if this information is not needed.

Return value

Type: HRESULT

This function can return one of these values.

Requirements