Expand Minimize

MI_DestinationOptions_SetHttpUrlPrefix function

Set the default HTTP URL prefix for transports that go over HTTP and HTTPS.

Syntax


 MI_INLINE MI_Result MI_DestinationOptions_SetHttpUrlPrefix(
  _Inout_  MI_DestinationOptions *options,
  _In_z_ const MI_Char *prefix
);

Parameters

options [in, out]

A pointer to a MI_DestinationOptions object returned from the MI_Application_NewDestinationOptions function.

prefix

A null-terminated string that represents the HTTP URL prefix ("HTTP" or "HTTPS").

Return value

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

Return codeDescription
MI_RESULT_OK

The operation succeeded.

MI_RESULT_SERVER_LIMITS_EXCEEDED

There is not enough memory to complete the request.

MI_RESULT_INVALID_PARAMETER

One or more parameters passed to the function were not valid.

MI_RESULT_FAILED

A failure not covered by other MI_Result error codes.

 

Remarks

The default URL prefix is protocol specific. This setting is ignored by transports that do not support this.

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Redistributable

Windows Management Framework 3.0 on Windows Server 2008 R2 with SP1, Windows 7 with SP1, and Windows Server 2008 with SP2

Header

Mi.h

See also

MI_DestinationOptions
MI_Application_NewDestinationOptions
MI_DestinationOptions_GetHttpUrlPrefix
MI_DestinationOptions_GetTransport
MI_DestinationOptions_SetTransport

 

 

Show:
© 2014 Microsoft