IPersistFolder2 Interface

IID_IPersistFolder2

{1AC3D9F0-175C-11d1-95BE-00609797EA4F

The IPersistFolder2 interface is used to obtain information from Shell folder objects. When implementing a Shell namespace extension, specifically the IShellFolder interface, you need to implement this interface so that the Shell folder object's ITEMIDLIST can be retrieved. It is an extension of the IPersistFolder interface.

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

IPersist Method

Description

GetClassID

Returns the class identifier (CLSID) for the component object.

IPersistFolder Method

Description

Initialize

Instructs a Shell folder object to initialize itself based on the information passed.

IPersistFolder2 Method

Description

GetCurFolder

Retrieves the ITEMIDLIST for the folder object.

GetClassID

FUNCTION IPersistFolder2_GetClassID ( _

  BYVAL pthis AS DWORD PTR _

, BYREF pClassID AS GUID _

  ) AS LONG
 

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[3] USING IPersistFolder2_GetClassID (pthis, pClassID) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

Initialize

FUNCTION IPersistFolder2_Initialize ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL pidl AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[4] USING IPersistFolder2_Initialize (pthis, pidl) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

GetCurFolder

FUNCTION IPersistFolder2_GetCurFolder ( _
  BYVAL pthis AS DWORD PTR _
, BYREF ppidl AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[5] USING IPersistFolder2_GetCurFolder (pthis, ppidl) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION