RegisterFormatEnumerator

Registers a FORMATETC enumerator object onto the given bind context.

HRESULT RegisterFormatEnumerator(

LPBC pbc,

//Pointer to the bind context

IEnumFORMATETC *pEFetc,

//Pointer to the IEnumFORMATETC interface

DWORD dwReserved

//Reserved for future use; must be zero

);

Parameters

pbc
[in] Pointer to the IBindCtx interface for the bind context on which to register the enumerator.
pEFetc
[in] Pointer to the IEnumFORMATETC interface for the enumerator to be registered.
dwReserved
[in] Reserved for future use; must be zero.

Return Values

S_OK
The operation was successful.
E_INVALIDARG
One or more parameters are invalid.

Remarks

The enumerator is used to determine what format types are prefered for the bind operation. Typically, the pEFetc parameter would be the pointer obtained through a call to CreateFormatEnumerator.

See Also

CreateFormatEnumerator, RevokeFormatEnumerator