Share via

IMAPasswordManagement.SetPassword Method

  • Article

Sets the password for the CSEntry object. This method is called when the call to the BeginConnectionToServer method is successful.

Namespace: Microsoft.MetadirectoryServices
Assembly: Microsoft.MetadirectoryServicesEx (in Microsoft.MetadirectoryServicesEx.dll)

Usage

'Usage
Dim instance As IMAPasswordManagement
Dim csentry As CSEntry
Dim NewPassword As String

instance.SetPassword(csentry, NewPassword)

Syntax

'Declaration
Sub SetPassword ( _
    csentry As CSEntry, _
    NewPassword As String _
)

void SetPassword (
    CSEntry csentry,
    string NewPassword
)

void SetPassword (
    CSEntry^ csentry, 
    String^ NewPassword
)

void SetPassword (
    CSEntry csentry, 
    String NewPassword
)

function SetPassword (
    csentry : CSEntry, 
    NewPassword : String
)

Parameters

  • csentry
    The CSEntry object with the password to be set.
  • NewPassword
    The new password. Use the value of this parameter to set the new password.

Exceptions

Exception type Condition
AccessDeniedException

The password extension failed to set the password in the connected directory.
ObjectTypeNotSupportedException

The object type does not support setting or changing passwords.
EntryPointNotImplementedException

The rules extension does not implement this method.
PasswordExtensionException

The password extension throws an unknown exception.
PasswordIllFormedException

The supplied password contains extended characters or invalid characters.
PasswordPolicyViolationException

The password does not comply with the password policy.
ServerDownException

The connected directory extension cannot establish a connection to the connected directory.

Remarks

Use the value of the NewPassword parameter as the new password instead of the export_password attribute of the CSEntry object. The export_password attribute might not have a value.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Target Platforms

See Also

Reference

IMAPasswordManagement Interface
IMAPasswordManagement Members
Microsoft.MetadirectoryServices Namespace
CSEntry Class
IMAPasswordManagement Interface