Error Handling (Windows Embedded CE 6.0)
1/5/2010
The following list describes the ways in which the APIs that are exposed by the Media Query Engine (MQE) can notify the calling program of error conditions:
- The MediaQueryEngine API can return Boolean values or can return an object, such as a smart pointer.
- If the MediaQueryEngine functions return Boolean values, those values indicate success or failure of the function. In case of failure, the MediaQueryEngine API functions set the last error. The last error definitions can be found in the winerror.h file.
- If the MediaQueryEngine functions return an object, call the IsValid method on the returned object to determine whether the function's execution was successful. If IsValid returns False, check the GetLastError function for more information about the failure.
- The MediaQueryEngine functions do not set the last error in case of success.
- In case of Universal Plug and Play (UPnP) errors, the MQE leaves the last error as set by UPnP, and indicates to the application that there is no data available.