| Previous | Next |
| FILTER_S_LAST_VALUES | FILTER_S_FULL_CONTENTSCAN_IMMEDIATE |
FILTER_S_PARTIAL_CONTENTSCAN_IMMEDIATE
Immediate partial content scan is required
FILTER_S_PARTIAL_CONTENTSCAN_IMMEDIATE is HRESULT 268081 (0x00041731) from Indexing Service. AllStat describes it as “A partial content scan of the disk needs to be scheduled for immediate execution.” The severity bit indicates a nonfailure result, but the value carries a specific condition that must not be collapsed into plain S_OK.
In the legacy Indexing Service or IFilter pipeline, this result means that a partial content scan of the disk needs to be scheduled for immediate execution. It is actionable success information: the result must be interpreted before the caller advances its workflow.
Where the status is encountered
- Legacy Indexing Service catalog processing; log the exact method and object state instead of interpreting the constant outside that contract.
- IFilter text and property extraction; log the exact method and object state instead of interpreting the constant outside that contract.
- Search enumeration, scan scheduling, or catalog administration; log the exact method and object state instead of interpreting the constant outside that contract.
Because it is informational, a language binding may expose it as success and hide the symbolic distinction. Keep the original HRESULT available until the code-specific branch has run.
What must be true before accepting it
Verify that the index manager can identify the affected scope and schedule only the portion whose content state changed. A valid return path and an application-level completed request are not automatically the same thing.
Determine whether ownership, buffers, callbacks, or resources changed before choosing recovery.
Evidence and telemetry
- preserve affected extension or scope.
- preserve catalog name and generation.
- preserve reason for invalidation.
- preserve queued scan identifier.
- preserve completion and item counts.
Also record filter_s_partial_contentscan_immediate_operation, filter_s_partial_contentscan_immediate_state_before, filter_s_partial_contentscan_immediate_state_after, UTC time, process and thread identifiers, component version, and a correlation ID. Support data for it should use hashes or GUIDs instead of sensitive content wherever possible.
Correct handling and recovery
Queue an immediate partial scan with the affected roots or work IDs, coalesce duplicates, and verify that the catalog generation advances after completion.
Retry it only when a documented input or state has changed. Repeat the operation after it only when evidence shows that an input, resource, or phase has changed.
Difference from nearby results
It must be distinguished from ordinary S_OK and from failure-severity values in the same API family; its documented state changes control the next action.
The code adjacent to it may require a different action even when both values have success severity.
Practical scenario
A filter update invalidates one file-type subset. The service schedules a partial scan immediately and confirms that unrelated catalog content is not rebuilt.
A regression test should reproduce it, assert the relevant outputs and state, then change only the decisive condition and verify the expected neighboring result or ordinary completion.
References
- Microsoft: Filter interface values — official Microsoft material used to interpret it.
- Microsoft: About Indexing Service filters
- Microsoft: Using custom filters
- Microsoft: HRESULT values
Looking for a different code? Search another status or error code.