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 版或更新版本) |