MI_Utilities_CimErrorFromErrorCode function (mi.h)

Maps an operating-system specific error code to a CIM error instance.

Syntax

MI_INLINE MI_Result MI_Utilities_CimErrorFromErrorCode(
       MI_Uint32     error,
  [in] const MI_Char *errorType,
  [in] const MI_Char *errorMessage,
       MI_Instance   **cimError
);

Parameters

error

Error code to translate.

[in] errorType

One of the following error types.

MI_RESULT_TYPE_MI

MI result type

MI_RESULT_TYPE_HRESULT

HRESULT (COM return type) result type

MI_RESULT_TYPE_WIN32

Win32 result type

[in] errorMessage

Error message to encode in the CIM error instance.

cimError

Returned CIM error instance. This must be deleted by using the MI_Instance_Delete function.

Return value

A value of the MI_Result enumeration that specifies the function return code. This can be one of the following codes.

Requirements

Requirement Value
Minimum supported client Windows 8
Minimum supported server Windows Server 2012
Target Platform Windows
Header mi.h
Redistributable Windows Management Framework 3.0 on Windows Server 2008 R2 with SP1, Windows 7 with SP1, and Windows Server 2008 with SP2