MI_Context_SetStringOption function (mi.h)

Sets a context-specific option.

Syntax

MI_INLINE MI_Result MI_INLINE_CALL MI_Context_SetStringOption(
  [in] MI_Context    *context,
       const MI_Char *name,
       const MI_Char *value
);

Parameters

[in] context

Request context.

name

A null-terminated string that represents the name of the option to change.

value

A null-terminated string that represents the new value for the specified option.

Return value

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

Remarks

This function allows the provider to adjust the server's behavior.

On Windows Server 2012, this function only supports the "SECURITY" option, which is used only by an indication provider to control which users have permission to subscribe to the indication class. The function is valid if and only if it is called inside the indication class's *_Load function.

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_GetCustomOption

MI_Context_GetCustomOptionAt

MI_Context_GetCustomOptionCount

MI_Context_GetNumberOption

MI_Context_GetStringOption