IEnumExtraSearch  Interface

IID_IEnumExtraSearch

{0E700BE1-9DB6-11D1-A1CE-00C04FD75D13}

The IEnumExtraSearch interface is a standard OLE enumerator that is used by a client to determine the available search objects for a folder.

Remarks

Implement IEnumExtraSearch if your namespace extension supports one or more search objects.

 

You do not call this interface directly. An IEnumExtraSearch interface is requested by a client only after it has determined that the IShellFolder2 interface is exposed. Clients retrieve a pointer to this interface by calling IShellFolder2::EnumSearches.

 

IEnumExtraSearch implements IUnknown and the standard OLE enumeration methods.

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

IEnumExtraSearch Methods

Description

Next

Used to request information on one or more search objects.

Skip

Skip past a specified number of objects.

Reset

Used to reset the enumeration index to zero.

Clone

Used to request a duplicate of the enumerator object to preserve its current state.

Next

FUNCTION IEnumExtraSearch_Next ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL celt AS DWORD _
, BYVAL rgelt AS DWORD _
, BYREF pceltFetched AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[3] USING IEnumExtraSearch_Next (pthis, celt, rgelt, pceltFetched) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

Skip

FUNCTION IEnumExtraSearch_Skip ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL celt AS DWORD _
  ) AS LONG

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

END FUNCTION

Reset

FUNCTION IEnumExtraSearch_Reset ( _
  BYVAL pthis AS DWORD PTR _
  ) AS LONG

  LOCAL HRESULT AS LONG

  CALL DWORD @@pthis[5] USING IEnumExtraSearch_Reset (pthis) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

Clone

FUNCTION IEnumExtraSearch_Clone ( _
  BYVAL pthis AS DWORD PTR _
, BYREF ppenum AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG

  CALL DWORD @@pthis[6] USING IEnumExtraSearch_Clone (pthis, ppenum) TO HRESULT

  FUNCTION = HRESULT

END FUNCTION