FolderItem  Object

CLSID_ShellFolderItem

{2FE352EA-FD1F-11D2-B1F4-00C04F8EEB3E}

IID_FolderItem

{FAC32C80-CBE4-11CE-8350-444553540000}

IID_FolderItem2

{EDC817AA-92B8-11D1-B075-00C04FC33AA5

The FolderItem object represents an item in a Shell folder. It contains properties and methods that allow you to retrieve information about the item.

The ShellFolderItem object extends FolderItem with two additional methods: InvokeVerbEx and ExtendedProperty.

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

IDispatch Methods

Description

GetTypeInfoCount

Retrieves the number of type information interfaces that an object provides (either 0 or 1).

GetTypeInfo

Gets the type information for an object.

GetIDsOfNames

Maps a single member and an optional set of argument names to a corresponding set of integer DISPIDs.

Invoke

Provides access to properties and methods exposed by an object.

FolderItem Methods and Properties

Description

Application

Contains the Application object of the folder item. This is a read-only property.

Parent

Contains the item's parent object.

Name

Sets or retrieves the item's name.

Path

Contains the item's full path and name.

GetLink

If the item is a shortcut, contains the item's ShellLinkObject object.

GetFolder

If the item is a folder, contains the item's Folder object.

IsLink

Indicates if the item is a shortcut.

IsFolder

Indicates if the item is a folder.

IsFileSystem

Indicates if the item is part of the file system.

IsBrowsable

Indicates if the item can be browsed.

ModifyDate

Sets or retrieves the date and time that a file was last modified. ModifyDate can be used to retrieve the data and time that a folder was last modified, but cannot set it.

Size

Contains the item's size, in bytes.

Type

Contains a string representation of the item's type.

Verbs

Retrieves the item's FolderItemVerbs object. This object is the collection of verbs that can be executed on the item.

InvokeVerb

Executes a verb on the item.

FolderItem2 Methods and Properties

Description

InvokeVerbEx

Executes a verb on a Shell item.

ExtendedProperty

Returns the value of a property from an item's property set. The property can be specified either by name or by the property set's format identifier (FMTID) and property identifier (PID).

Application

FUNCTION ShellFolderItem_get_Application ( _
  BYVAL pthis AS DWORD PTR _
, BYREF ppid AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[7] USING ShellFolderItem_get_Application (pthis, ppid) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

Parent

FUNCTION ShellFolderItem_get_Parent ( _
  BYVAL pthis AS DWORD PTR _
, BYREF ppid AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[8] USING ShellFolderItem_get_Parent (pthis, ppid) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

Name

FUNCTION ShellFolderItem_get_Name ( _
  BYVAL pthis AS DWORD PTR _
, BYREF pbs AS STRING _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[9] USING ShellFolderItem_get_Name (pthis, pbs) TO HRESULT
  FUNCTION = HRESULT
  pbs = ACODE$(pbs)

END FUNCTION

FUNCTION ShellFolderItem_put_Name ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL pbs AS STRING _
  ) AS LONG

  LOCAL HRESULT AS LONG
  pbs = UCODE$(pbs)
  CALL DWORD @@pthis[10] USING ShellFolderItem_put_Name (pthis, pbs) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

Path

FUNCTION ShellFolderItem_get_Path ( _
  BYVAL pthis AS DWORD PTR _
, BYREF pbs AS STRING _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[11] USING ShellFolderItem_get_Path (pthis, pbs) TO HRESULT
  FUNCTION = HRESULT
  pbs = ACODE$(pbs)

END FUNCTION

GetLink

FUNCTION ShellFolderItem_get_GetLink ( _
  BYVAL pthis AS DWORD PTR _
, BYREF ppid AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[12] USING ShellFolderItem_get_GetLink (pthis, ppid) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

GetFolder

FUNCTION ShellFolderItem_get_GetFolder ( _
  BYVAL pthis AS DWORD PTR _
, BYREF ppid AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[13] USING ShellFolderItem_get_GetFolder (pthis, ppid) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

IsLink

FUNCTION ShellFolderItem_get_IsLink ( _
  BYVAL pthis AS DWORD PTR _
, BYREF pb AS INTEGER _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[14] USING ShellFolderItem_get_IsLink (pthis, pb) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

IsFolder

FUNCTION ShellFolderItem_get_IsFolder ( _
  BYVAL pthis AS DWORD PTR _
, BYREF pb AS INTEGER _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[15] USING ShellFolderItem_get_IsFolder (pthis, pb) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

IsFileSystem

FUNCTION ShellFolderItem_get_IsFileSystem ( _
  BYVAL pthis AS DWORD PTR _
, BYREF pb AS INTEGER _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[16] USING ShellFolderItem_get_IsFileSystem (pthis, pb) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

IsBrowsable

FUNCTION ShellFolderItem_get_IsBrowsable ( _
  BYVAL pthis AS DWORD PTR _
, BYREF pb AS INTEGER _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[17] USING ShellFolderItem_get_IsBrowsable (pthis, pb) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

ModifyDate

FUNCTION ShellFolderItem_get_ModifyDate ( _
  BYVAL pthis AS DWORD PTR _
, BYREF pdt AS DOUBLE _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[18] USING ShellFolderItem_get_ModifyDate (pthis, pdt) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

FUNCTION ShellFolderItem_put_ModifyDate ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL pdt AS DOUBLE _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[19] USING ShellFolderItem_put_ModifyDate (pthis, pdt) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

Size

FUNCTION ShellFolderItem_get_Size ( _
  BYVAL pthis AS DWORD PTR _
, BYREF pul AS LONG _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[20] USING ShellFolderItem_get_Size (pthis, pul) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

Type

FUNCTION ShellFolderItem_get_Type ( _
  BYVAL pthis AS DWORD PTR _
, BYREF pbs AS STRING _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[21] USING ShellFolderItem_get_Type (pthis, pbs) TO HRESULT
  FUNCTION = HRESULT
  pbs = ACODE$(pbs)

END FUNCTION
 

Verbs

FUNCTION ShellFolderItem_Verbs ( _
  BYVAL pthis AS DWORD PTR _
, BYREF ppfic AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[22] USING ShellFolderItem_Verbs (pthis, ppfic) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

InvokeVerb

FUNCTION ShellFolderItem_InvokeVerb ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL vVerb AS VARIANT _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[23] USING ShellFolderItem_InvokeVerb (pthis, vVerb) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

InvokeVerbEx

FUNCTION ShellFolderItem2_InvokeVerbEx ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL vVerb AS VARIANT _
, BYVAL vArgs AS VARIANT _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[24] USING ShellFolderItem2_InvokeVerbEx (pthis, vVerb, vArgs) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

ExtendedProperty

FUNCTION ShellFolderItem2_ExtendedProperty ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL bstrPropName AS STRING _
, BYREF pvRet AS VARIANT _
  ) AS LONG

  LOCAL HRESULT AS LONG
  bstrPropName = UCODE$(bstrPropName)
  CALL DWORD @@pthis[25] USING ShellFolderItem2_ExtendedProperty (pthis, bstrPropName, pvRet) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION