| Previous | Next |
| NS_E_WMP_HME_STALEREQUEST | NS_E_WMP_WINDOWSAPIFAILURE |
NS_E_WMP_ADDTOLIBRARY_FAILED
The exact condition behind the dialog
0xC00D0FC7 maps to NS_E_WMP_ADDTOLIBRARY_FAILED. Its actionable interpretation is the Player failed while creating or committing a library entry for the supplied item within the Windows Media Player library and media database; the producing mechanism is the library layer that records media paths, creates Media objects, scans folders, resolves object identifiers and coordinates shared-library requests.
An additional test is to record path, access-rights level, MediaCollection. Add result and any conversion/metadata sub-error; that evidence is more useful than reinstalling the Player or changing several unrelated settings at once.
Evidence to capture before retry
Preserve the first occurrence before retry or fallback changes the add to library failed evidence. Capture one consistent object instance:
| Field | What to record |
|---|---|
| What to verify | Record path, access-rights level, MediaCollection. Add result and any conversion/metadata sub-error |
| Artifact identity | First library or file-system HRESULT before the Player-level summary for the add to library failed reproduction |
| Runtime state | Library type, database identity and user profile owning the operation for this reproduction |
| Owning object | Canonical local/UNC/URL path and file identity for this reproduction |
| Lower-level result | Media object ID or HME container/item ID for this reproduction |
| Correlation | Scan/search generation and the request that superseded it for this reproduction |
How this layer works
this workflow must be separated from a generic WMP failure: adding an item to the library does not move the underlying file, and a library row can survive after its path or shared object becomes unavailable. It also matters that a scan, search or Home Media Experience request is stateful, so stale identifiers and overlapping operations must be separated from file-format failures.
Representative case: A file is readable by the host but the embedded control lacks full library access.
A focused diagnostic sequence
- Find the first component that returned this result and label that event as the failure point.
- Freeze the input and object identity associated with the failing operation before WMP fallback or cleanup changes it.
- Reconstruct the immediately preceding successful state, then identify the call or event that crossed into failure.
- Perform the code-specific test: record path, access-rights level, MediaCollection. Add result and any conversion/metadata sub-error.
- Make the targeted change—correct the specific path/access/conversion failure and add the same item once—and repeat the same producing operation.
Correct the producing condition
Resolve this result where the relevant state is produced: correct the specific path/access/conversion failure and add the same item once. After correction, reload or recreate the owning object so cached failure state is not mistaken for a successful repair.
- Avoid deleting the entire media database before exporting the failing object IDs and paths; it can destroy the artifact or state needed to explain this result.
- Avoid assuming a successful file open proves that the library record and sharing view are current; that can replace the original HRESULT with a secondary failure from another layer.
Why the symbolic name matters
| Result | Different condition |
|---|---|
NS_E_MPDB_GENERIC | The media database operation failed without a narrower library HRESULT |
NS_E_WMP_HME_STALEREQUEST | The HME request belongs to an older library or navigation state |
NS_E_WMP_HME_NOTSEARCHABLEFORITEMS | The selected HME container does not advertise item-search capability |
Regression check
Discriminating evidence: Capture the media-library database operation, item path and first storage or metadata failure returned while adding the item. This is an insertion failure; a library scan that is merely already running has a different state transition and does not prove database insertion failed.
Technical references
- Accessing the library programmatically — normative or platform material relevant to this HRESULT.
- MediaCollection object — API or format context.
- MediaCollection. Add method — documentation for this HRESULT.
- Error handling in the WMP object model
Looking for a different code? Search another status or error code.