| Previous | Next |
| MQ_ERROR_DS_BIND_ROOT_FOREST | MQ_ERROR_Q_ADS_PROPERTY_NOT_SUPPORTED |
MQ_ERROR_DS_LOCAL_USER
Interpretation
Applications should keep MQ_ERROR_DS_LOCAL_USER attached to the exact MSMQ call that produced it; translating it immediately to “queue error” discards the diagnostic boundary. Its diagnostic boundary is local account reaches AD DS as anonymous. Only an authenticated domain identity can perform the requested directory operation.
For MQ_ERROR_DS_LOCAL_USER, global catalog searches and writes to a writable domain naming context have different capabilities. When diagnosing MQ_ERROR_DS_LOCAL_USER, record whether the operation was discovery, read, create, update, or delete before choosing a domain controller.
When diagnosing MQ_ERROR_DS_LOCAL_USER, A domain join, a successful DNS lookup, and an LDAP bind are separate checkpoints. In the MQ_ERROR_DS_LOCAL_USER path, directory errors must be correlated with the exact naming context, object class, GUID, and domain controller used by MSMQ.
Relevant API contract
| Subsystem | MSMQ integration with Active Directory Domain Services and the global catalog |
|---|---|
| Decisive boundary | public queue metadata and MSMQ configuration objects depend on directory reachability, schema, class, ownership, and domain credentials |
| Code-specific focus | local account reaches AD DS as anonymous |
| Primary recovery rule | Run under a domain account or avoid the directory-dependent feature. |
When diagnosing MQ_ERROR_DS_LOCAL_USER, A queue can exist locally while its public registration or MSMQ configuration object is absent, stale, wrong-class, or visible only on some domain controllers. For MQ_ERROR_DS_LOCAL_USER, the code-specific boundary is local account reaches AD DS as anonymous.
Decisive observations
- The directory object class, guid, owner, and replication state; associate it explicitly with
MQ_ERROR_DS_LOCAL_USER. - When diagnosing
MQ_ERROR_DS_LOCAL_USER, domain/workgroup mode, forest and domain names, and selected domain controller; capture the value before cleanup or retry changes it. - In the
MQ_ERROR_DS_LOCAL_USERpath, dns and ldap reachability plus the distinguished name being accessed; compare it with a known-good call using the same account and queue type. - For this
MQ_ERROR_DS_LOCAL_USERresult, record the queue path or format name, local/remote placement, transactional flag, caller SID, process build, and UTC correlation ID when they apply.
For MQ_ERROR_DS_LOCAL_USER, log certificate thumbprints, provider names, SIDs, GUIDs, lengths, and hashes where useful, but do not log private keys, symmetric keys, credentials, or confidential message bodies.
Troubleshooting workflow
- Record the unsigned HRESULT,
MQ_ERROR_DS_LOCAL_USER, and the native API or COM method before a framework replaces it with a generic exception. - When diagnosing
MQ_ERROR_DS_LOCAL_USER, capture DNS and LDAP reachability plus the distinguished name being accessed. - In the
MQ_ERROR_DS_LOCAL_USERpath, capture the directory object class, GUID, owner, and replication state. - Reproduce with the smallest queue/message/property set that still returns
MQ_ERROR_DS_LOCAL_USER; change one precondition at a time. - For
MQ_ERROR_DS_LOCAL_USER, verify the postcondition after the failed call: queue existence, message presence, directory object state, transaction outcome, or generated output may differ by result. - When diagnosing
MQ_ERROR_DS_LOCAL_USER, apply the code-specific recovery rule: Run under a domain account or avoid the directory-dependent feature.
Recovery rules
Run under a domain account or avoid the directory-dependent feature.
When diagnosing MQ_ERROR_DS_LOCAL_USER, the retry decision must account for side effects that may already exist. In the MQ_ERROR_DS_LOCAL_USER path, query queue, message, directory, or transaction state first whenever the result leaves completion uncertain.
Differences that matter
In the MQ_ERROR_DS_LOCAL_USER path, local private-queue success does not prove that public-queue registration, global catalog discovery, or the required AD DS object is healthy. The specific focus for MQ_ERROR_DS_LOCAL_USER remains local account reaches AD DS as anonymous.
- In the
MQ_ERROR_DS_LOCAL_USERpath, changing queue names, deleting directory objects, or recreating certificates without reconciliation can create a second object while callers still reference the first. - For this
MQ_ERROR_DS_LOCAL_USERresult, A successful test under an interactive administrator account does not prove that the production service account has the same profile, token, directory access, or key permissions.
Practical scenario
A public-queue discovery service encounters MQ_ERROR_DS_LOCAL_USER. For MQ_ERROR_DS_LOCAL_USER, it compares DNS, LDAP bind, object class, and replication on the exact domain controller used by MSMQ. When diagnosing MQ_ERROR_DS_LOCAL_USER, the acceptance test then changes only the decisive precondition and confirms both the HRESULT and the actual queue/message state.
A regression test should force MQ_ERROR_DS_LOCAL_USER, assert the raw value and relevant outputs, then correct only the documented precondition and verify the intended success or neighboring HRESULT.
Sources
- Microsoft Open Specifications: MSMQ protocols overview — source used for the
MQ_ERROR_DS_LOCAL_USERanalysis. - IETF RFC 4511: LDAP protocol — source used for the
MQ_ERROR_DS_LOCAL_USERanalysis. - Microsoft: destination queues — source used for the
MQ_ERROR_DS_LOCAL_USERanalysis. - Microsoft: Message Queuing error and information codes — source used for the
MQ_ERROR_DS_LOCAL_USERanalysis. - Microsoft Open Specifications: MSMQ and directory services — source used for the
MQ_ERROR_DS_LOCAL_USERanalysis.
Looking for a different code? Search another status or error code.