IMAPasswordManagement::SetPassword Method

Article
02/16/2009

The IMAPasswordManagement.SetPassword(CSEntry, String) sets the password for the CSEntry object. This method is called when the call to the BeginConnectionToServer method is successful.

Syntax

public void SetPassword(
  CSEntry csentry,
  String NewPassword
);

Public Sub SetPassword( _
  ByVal csentry As CSEntry, _
  ByVal NewPassword As String _
)
Implements IMAPasswordManagement.SetPassword

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.

Return Value

This method does not return a value.

Exceptions

Exception type	Condition
AccessDeniedException	The password extension fails 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 rather than the export_password attribute of the CSEntry object. It's possible that the export_password attribute might not have a value.

Requirements

Product	Microsoft Identity Integration Server 2003 SP1
Namespace	Microsoft.MetadirectoryServices
Assembly	Microsoft.MetadirectoryServices
.NET Framework	.NET Framework 2.0

Partager via