Skip to main content
MI_DestinationOptions_AddDestinationCredentials function

Sets the credentials for talking to the destination.

Syntax


 MI_INLINE MI_Result MI_DestinationOptions_AddDestinationCredentials(
  _Inout_  MI_DestinationOptions *options,
  _In_     const MI_UserCredentials *credentials
);

Parameters

options [in, out]

A pointer to a destination options structure.

credentials [in]

Credentials used when communicating with the destination machine.

Return value

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 credentials supported will vary depending on the destination, the protocol and the transport. If dual-factor authentication is required this method can be called twice. The default credentials will vary depending on the protocol and transport selected.

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