Condividi tramite

Funzione SHGetAttributesFromDataObject (shlobj_core.h)

  • Articolo

[SHGetAttributesFromDataObject è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Può essere modificato o non disponibile nelle versioni successive.

Recupera le informazioni specificate da un oggetto dati di sistema.

Sintassi

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

Parametri

[in, optional] pdo

Tipo: IDataObject*

Oggetto dati da cui recuperare le informazioni.

dwAttributeMask

Tipo: DWORD

Uno o più flag SFGAO che indicano quali informazioni l'applicazione chiamante vuole recuperare.

[out, optional] pdwAttributes

Tipo: DWORD*

Puntatore a un valore DWORD che, quando questa funzione restituisce correttamente, riceve uno o più flag SFGAO che indicano gli attributi, tra quelli richiesti, comuni a tutti gli elementi del pdo. Questo puntatore può essere NULL se queste informazioni non sono necessarie.

[out, optional] pcItems

Tipo: UINT*

Puntatore a un oggetto UINT che, quando questa funzione restituisce correttamente, riceve il numero di PIDL nell'oggetto dati a cui fa riferimento il pdo. Questo puntatore può essere NULL se queste informazioni non sono necessarie.

Valore restituito

Tipo: HRESULT

Questa funzione può restituire uno di questi valori.

Codice restituito Descrizione
S_OK
 Operazione completata.
S_FALSE
 L'oggetto non è un oggetto dati di sistema. In questo caso, pdwAttributes è impostato su 0.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shlobj_core.h (include Shlobj.h)
Libreria Shell32.lib
DLL Shell32.dll (versione 6.0 o successiva)