IPersistFolder Interface

IID_IPersistFolder

{000214EA-0000-0000-C000-000000000046}

The IPersistFolder interface is used to initialize Shell folder objects.

When implementing a Shell namespace extension, specifically the IShellFolder interface, you need to implement this interface so the folder object can be initialized. Implementation of this interface is how the folder is told where it is in the Shell namespace.

You do not use this interface directly. It is used by the file system implementation of the IShellFolder::BindToObject interface when it is initializing a Shell folder object.

IPersistFolder is derived from IPersist. The listed method is specific to IPersistFolder.

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.

GetClassID

FUNCTION IPersistFolder_GetClassID ( _

  BYVAL pthis AS DWORD PTR _

, BYREF pClassID AS GUID _

  ) AS LONG
 

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

END FUNCTION

Initialize

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

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

END FUNCTION