IOleItemContainer Interface

IID_IOleItemContainer

{0000011C-0000-0000-C000-000000000046}

The IOleItemContainer interface is used by item monikers when they are bound to the objects they identify.

When any container of objects uses item monikers to identify its objects, it must define a naming scheme for those objects. The container's IOleItemContainer implementation uses knowledge of that naming scheme to retrieve an object given a particular name. Item monikers use the container's IOleItemContainer implementation during binding.

Applications typically do not call IOleItemContainer methods directly. The item moniker implementation of IMoniker is the primary caller of IOleItemContainer methods.

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

IParseDisplayName Method

Description

ParseDisplayName

Parses the display name returning a moniker corresponding to it.

IOleContainer Methods

Description

EnumObjects

Enumerates objects in a container.

LockContainer

Keeps container running until explicitly released.

IOleItemContainer Methods

Description

GetObject

Returns a pointer to a specified object.

GetObjectStorage

Returns a pointer to an object's storage.

IsRunning

Checks whether an object is running.

GetObject

FUNCTION IOleItemContainer_GetObject ( _

  BYVAL pthis AS DWORD PTR _

, BYVAL pszItem AS DWORD _

, BYVAL dwSpeedNeeded AS DWORD _

, BYVAL pbc AS DWORD _

, BYREF riid AS GUID _

, BYREF ppvObject AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[6] USING IOleItemContainer_GetObject (pthis, pszItem, dwSpeedNeeded, pbc, riid, ppvObject) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

GetObjectStorage

FUNCTION IOleItemContainer_GetObjectStorage ( _

  BYVAL pthis AS DWORD PTR _

, BYVAL pszItem AS DWORD _

, BYVAL pbc AS DWORD _

, BYREF riid AS GUID _

, BYREF ppvStorage AS DWORD _

  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[7] USING IOleItemContainer_GetObjectStorage (pthis, pszItem, pbc, riid, ppvStorage) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

IsRunning

FUNCTION IOleItemContainer_IsRunning ( _

  BYVAL pthis AS DWORD PTR _

, BYVAL strItem AS STRING _

  ) AS LONG

  LOCAL HRESULT AS LONG

  strItem = UCODE$(strItem) & $NUL
  CALL DWORD @@pthis[8] USING IOleItemContainer_IsRunning (pthis, strItem) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION