IShellFolder：：GetAttributesOf 方法 (shobjidl_core.h)

  • 發行項

取得 IShellFolder所表示之 物件中包含的一或多個檔案或資料夾物件的屬性。

語法

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

參數

[in] cidl

類型： UINT

要從中擷取屬性的專案數目。

[in] apidl

類型： PCUITEMID_CHILD_ARRAY*

ITEMIDLIST結構的指標陣列位址，每個結構都會唯一識別相對於父資料夾的專案。 每個 ITEMIDLIST 結構必須只包含一個 SHITEMID 結構，後面接著終止零。

[in, out] rgfInOut

類型： SFGAOF*

專案上單一 ULONG 值的指標包含呼叫應用程式所要求的位 SFGAO 屬性。 結束時，這個值包含所有指定專案通用的要求屬性。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

若要優化此作業，請勿傳回未指定的旗標。

對於資料夾物件， SFGAO_BROWSABLE 屬性工作表示用戶端可以系結至此物件，如此處的一般形式所示。

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

然後，用戶端就可以透過此語句在該專案上建立 IShellView 。

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

SFGAO_DROPTARGET屬性工作表示用戶端可以呼叫IShellFolder：：GetUIObjectOf，系結至此資料夾的IDropTarget實例，如下所示。

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

SFGAO_NONENUMERATED屬性工作表示 IShellFolder：：EnumObjects 方法所建立的列舉值未傳回的專案。

需求

   
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 shobjidl_core.h (包括 Shobjidl.h)
Dll Shell32.dll (4.0 版或更新版本)

另請參閱

IShellFolder

IShellFolder2