About Configuration Manager Errors
Updated: November 1, 2013
Applies To: System Center 2012 Configuration Manager, System Center 2012 Configuration Manager SP1, System Center 2012 R2 Configuration Manager
In System Center 2012 R2 Configuration Manager, when a Configuration Manager error occurs it is either a Windows Management Instrumentation (WMI) or a SMS Provider error.
A WMI error is reported in an instance of __ExtendedStatus. An SMS Provider error is reported in an instance of SMS_ExtendedStatus.
How you process an error depends on the programming language that you are using.
Error Handling with WMI
In VBScript the error object Number property is non-zero if an error occurs during synchronous operation. Typically, you check this value after making changes to, or querying, the SMS Provider. In an asynchronous operation you receive an error object of the OnCompleted callback function.
After you get the error object instance, you can check the __Class property to determine the origin of the error. WMI creates an instance of __ExtendedStatus for WMI errors, and the SMS Provider creates an instance of SMS_ExtendedStatus for SMS Provider errors. SMS_ExtendedStatus is derived from __ExtendedStatus. The details of an SMS Provider error can also be found in SMSProv.log.
For more information see, How to Handle Configuration Manager Synchronous Errors by Using WMI.
Error Handling with the Managed SMS Provider
To handle Configuration Manager errors by using the managed SMS Provider, you catch the Configuration Manager-specific exceptions.
SmsQueryException is raised when a Configuration Manager query error occurs. It provides exception information specific to Configuration Manager (SMS_ExtendedStatus) and also encapsulates any WMI exceptions raised.
SmsQueryException.ErrorCode maps to the equivalent System.ManagementException exception code.
SmsQueryException.ExtendStatusCode maps to the SMS Provider error code raised in SMS_ExtendedStatus.ErrorCode.
SmsConnectionException is raised when the connection to WMI is lost.
SmsException is the base class from which SmsQueryException and SmsConnectionException derive. It is never raised but can be caught to catch both SmsQueryException and SmsConnectionException.
Accessing the __ExtendedStatus and the SMS_ExtendedStatus objects
Because the __ExtendedStatus and SMS_ExtendedStatus are not wrapped by the managed SMS Provider, you must use the System.Management ManagedException object.
If you do not need access to the error WMI objects, you can get access to an exception details string in SMSException.Details.
For more information about handling synchronous exceptions, see How to Handle Configuration Manager Synchronous Errors by Using Managed Code.
For more information about handling asynchronous exceptions, see How to Handle Configuration Manager Asynchronous Errors by Using Managed Code.
TasksHow to Handle Configuration Manager Synchronous Errors by Using WMI
How to Handle Configuration Manager Asynchronous Errors by Using WMI
How to Handle Configuration Manager Asynchronous Errors by Using Managed Code
How to Handle Configuration Manager Synchronous Errors by Using Managed Code