IBindCtx::EnumObjectParam

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.

HRESULT EnumObjectParam(

IEnumString **ppenum

//Indirect pointer to the enumerator object

);

Parameter

ppenum: [out] Indirect pointer to the IEnumString interface on the enumerator. If an error occurs, *ppenum is set to NULL. If *ppenum is non-NULL, the implementation calls IUnknown::AddRef on the parameter; it is the caller’s responsibility to call IUnknown::Release.

Return Values

This method supports the standard return value E_OUTOFMEMORY, as well as the following:

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 ones previously specified in calls to IBindCtx::RegisterObjectParam.

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.

IEnumString **ppenum	//Indirect pointer to the enumerator object
);