What does HRESULT 0x87C51048 (UTC_E_FILTER_FUNCTION_RESTRICTED) mean?

 
Previous Next
UTC_E_FILTER_VARIABLE_NOT_FOUND UTC_E_FILTER_VERSION_MISMATCH

UTC_E_FILTER_FUNCTION_RESTRICTED

Interpret the result in context: filter function context policy

UTC_E_FILTER_FUNCTION_RESTRICTED has the unsigned value 0x87C51048. In UTC it comes from scenario filter parser and evaluator, where filter function context policy owns the decision. Start by locating the exact scenario-engine boundary that emitted this value. The immediate contract failed because the function exists but is forbidden in the current filter context or evaluation phase, so diagnosis should remain at that boundary until a controlled comparison crosses it.

Build a minimal evidence set

UTC diagnostic fieldValue
Owning state or objectfilter function context policy
Producing layerscenario filter parser and evaluator
Do not confuse withUTC_E_FILTER_INVALID_FUNCTION means the evaluator does not support the named function at all
Evidence to collectfunction name, command context, scenario/destination, schema version and restriction rule
Narrow comparisoncall the same function in an allowed context with identical argument values

Run an A/B check

  1. Associate this result with one request, one scenario version and one service process ID.
  2. Save function name, command context, scenario/destination, schema version and restriction rule and the first lower-level HRESULT if one exists.
  3. Change no policy, provider set or destination except for this test: call the same function in an allowed context with identical argument values.
  4. Compare the produced artifacts and operational events, not only the top-level return value.

Nearby result: UTC_E_FILTER_INVALID_FUNCTION — means the evaluator does not support the named function at all.

Typed-filter note

Save the filter after variable substitution and type inference, not only the authoring XML. A visually plausible expression can still fail because the runtime command table, scope or operand types differ from the authoring tool. Test with one synthetic event whose fields and types are known exactly.

Safe remediation

Move the computation to an allowed phase or choose a permitted function.

Technical references


Looking for a different code? Search another status or error code.