MI_Context_PostError function (mi.h)

Providers call this function to post a return code to the client in response to a request.

Syntax

MI_INLINE MI_Result MI_INLINE_CALL MI_Context_PostError(
  [in] MI_Context    *context,
       MI_Uint32     resultCode,
       const MI_Char *resultType,
       const MI_Char *errorMessage
);

Parameters

[in] context

A pointer to the request context.

resultCode

The Result code to be sent to the client.

resultType

A null-terminated string that represents the type of the result code. The string can be one of these values or an arbitrary value defined by the provider.

MI_RESULT_TYPE_MI ("MI")

MI result type

MI_RESULT_TYPE_HRESULT ("HRESULT")

HRESULT (COM return type) result type

MI_RESULT_TYPE_WIN32 ("WIN32")

Win32 result type

errorMessage

A null-terminated string that represents the error message to be sent to the client. The message should be in the requested UI locale, if possible.

Return value

This function returns MI_INLINE MI_Result MI_INLINE_CALL.

Remarks

After an error is posted, the request context must not be used, because it becomes invalid at this point.

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

See also

MI_Context

MI_Context_WriteError