IBindCtx::EnumObjectParam (Windows CE 5.0)

Send Feedback

This method supplies a pointer to an IEnumString interface on an enumerator that can return the keys of the bind context's string-keyed table of pointers.

The IBindCtx::EnumObjectParam method is supported in DCOM, but it is not supported in COM.

Calling this method in COM returns a value of E_NOTIMPL.

HRESULT EnumObjectParam(IEnumString** ppenum);

Parameters

  • ppenum
    [out] Address of the IEnumString* pointer variable that receives the interface pointer to the enumerator.

    If an error occurs, *ppenum is set to NULL.

    If *ppenum is non-NULL, the implementation calls the IUnknown::AddRef method on the *ppenum.

    It is the caller's responsibility to call the IUnknown::Release method.

Return Values

The following table shows the return values for this method.

Value Description
E_NOTIMPL The method is not currently implemented.
E_OUTOFMEMORY A standard return value.
S_OK An enumerator was successfully created and the pointer supplied.

Remarks

This method provides an IEnumString pointer to an enumerator that can return the keys of the bind context's string-keyed table of pointers.

The keys returned are the same as previously specified in calls to the IBindCtx::RegisterObjectParam method.

To determine whether the platform supports this interface, see Determining Supported COM APIs.

Notes to Callers

A bind context maintains a table of interface pointers, each associated with a string key. This enables communication between a moniker implementation and the caller that initiated the binding operation.

One party can store an interface pointer under a string known to both parties so that the other party can later retrieve it from the bind context.

Requirements

OS Versions: Windows CE 2.0 and later.
Header: Objidl.h, Objidl.idl.
Link Library: Ole32.lib.

See Also

IBindCtx | IEnumString | IBindCtx::RegisterObjectParam | IUnknown::AddRef | IUnknown::Release

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.