# 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