Microsoft Identity Integration Server 2003 Developer Reference


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.
public abstract void SetPassword(
  CSEntry csentry,
  String NewPassword
[Visual Basic .NET]
Public MustOverride Sub SetPassword( _
  ByVal csentry As CSEntry, _
  ByVal NewPassword As String _
Implements IMAPasswordManagement.SetPassword


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

Return Values

This method has no return values.


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.


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.


Product: Microsoft Identity Integration Server 2003 Service Pack 1
Namespace: Defined in Microsoft.MetadirectoryServices.
Assembly: Requires Microsoft.MetadirectoryServices (in Microsoft.MetadirectoryServices.dll).
.NET Framework: Requires .NET Framework 1.1.

See Also