Export (0) Print
Expand All
Expand Minimize

MI_DestinationOptions_SetTransport function

Sets the transport to be used to communicate with the destination machine.

Syntax


 MI_INLINE MI_Result MI_DestinationOptions_SetTransport(
  _Inout_  MI_DestinationOptions *options,
  _In_z_ const MI_Char *transport
);

Parameters

options [in, out]

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

transport

A null-terminated string that represents the transport setting. The value can be any of these constants.

ValueMeaning
MI_DESTINATIONOPTIONS_TRANSPORT_HTTP
"HTTP"

HTTP protocol. Even with HTTP, some authentication schemes allow the payload to be encrypted using the authentication token. Some examples of this include Kerberos, Negotiate, and CredSSP. However, HTTP headers will still be in plain text.

MI_DESTINATIONOPTIONS_TRANPSORT_HTTPS
"HTTPS"

HTTPS protocol where the channel is encrypted. Note the misspelling of "TRANPSORT".

 

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

Not all protocols allow different underlying transports to be selected. If not supported, this setting will be ignored.

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_GetTransport

 

 

Show:
© 2014 Microsoft