DISM API Troubleshooting
Use the Deployment Image Servicing and Management (DISM) API to build customized solutions on the DISM platform. You can troubleshoot your solution in development by reviewing the errors and warnings in the DISM API log file. You can change the location and the level of information you want to receive for the log file during your call to the DismInitialize Function.
For more information about best practices when coding with the DISMAPI, see Using the DISM API.
DISMAPI Error Messages
The following DISMAPI messages may be reported in the log files when an error occurs.
| Message ID | Message Text |
|---|---|
| DISMAPI_E_DISMAPI_ALREADY_INITIALIZED | DISM API was already initialized for this process |
| DISMAPI_E_DISMAPI_NOT_INITIALIZED | DISM API was not initialized for this process |
| DISMAPI_E_SHUTDOWN_IN_PROGRESS | A DismSession was being shutdown when another operation was called on it |
| DISMAPI_E_OPEN_SESSION_HANDLES | DismShutdown was called while there were open DismSession handles |
| DISMAPI_E_INVALID_DISM_SESSION | An invalid DismSession handle was passed into a DISMAPI function |
| DISMAPI_E_INVALID_IMAGE_INDEX | An invalid image index was specified |
| DISMAPI_E_INVALID_IMAGE_NAME | An invalid image name was specified |
| DISMAPI_E_UNABLE_TO_UNMOUNT_IMAGE_PATH | An image that is not a mounted WIM or mounted VHD was attempted to be unmounted |
| DISMAPI_E_LOGGING_DISABLED | Failed to gain access to the log file user specified. Logging has been disabled |
Windows Error Messages
Standard Windows errors may also be reported during a DISMAPI process. You can obtain more information about any listed Win32 system error codes by typing net helpmsg on the command line and, then typing the error code number. For more information about System Error Codes, see System Error Codes (0-499).