Metodo IShellFolder::GetAttributesOf (shobjidl_core.h)

Articolo
03/15/2023

Ottiene gli attributi di uno o più oggetti file o cartelle contenuti nell'oggetto rappresentato da IShellFolder.

Sintassi

HRESULT GetAttributesOf(
  [in]      UINT                  cidl,
  [in]      PCUITEMID_CHILD_ARRAY apidl,
  [in, out] SFGAOF                *rgfInOut
);

Parametri

[in] cidl

Tipo: UINT

Numero di elementi da cui recuperare gli attributi.

[in] apidl

Tipo: PCUITEMID_CHILD_ARRAY*

Indirizzo di una matrice di puntatori alle strutture ITEMIDLIST , ognuna delle quali identifica in modo univoco un elemento relativo alla cartella padre. Ogni struttura ITEMIDLIST deve contenere esattamente una struttura SHITEMID seguita da uno zero finale.

[in, out] rgfInOut

Tipo: SFGAOF*

Puntatore a un singolo valore ULONG che, nella voce, contiene gli attributi SFGAO bit per bit richiesti dall'applicazione chiamante. In uscita, questo valore contiene gli attributi richiesti comuni a tutti gli elementi specificati.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Per ottimizzare questa operazione, non restituire flag non specificati.

Per un oggetto cartella, l'attributo SFGAO_BROWSABLE implica che il client può associare a questo oggetto, come illustrato in un modulo generale qui.

IShellFolder::BindToObject(..., pidl, IID_IShellFolder, &psfItem);

Il client può quindi creare un oggetto IShellView in tale elemento tramite questa istruzione.

psfItem->CreateViewObject(..., IID_IShellView,...);

L'attributo SFGAO_DROPTARGET implica che il client può eseguire il binding a un'istanza di IDropTarget per questa cartella chiamando IShellFolder::GetUIObjectOf , come illustrato qui.

IShellFolder::GetUIObjectOf(hwnd, 1, &pidl, IID_IDropTarget, NULL, &pv)

L'attributo SFGAO_NONENUMERATED indica un elemento non restituito dall'enumeratore creato dal metodo IShellFolder::EnumObjects .

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)
DLL	Shell32.dll (versione 4.0 o successiva)

Vedi anche

IShellFolder

IShellFolder2

Condividi tramite