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.
See Also