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               
                                                                                              

   );                                                                                         
                                                                                              

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