Microsoft Identity Integration Server 2003 Developer Reference

IMAPasswordManagement.SetPassword

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.

[C#]
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

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 Values

This method has no return values.

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 Service Pack 1
Namespace: Defined in Microsoft.MetadirectoryServices.
Assembly: Requires Microsoft.MetadirectoryServices (in Microsoft.MetadirectoryServices.dll).
.NET Framework: Requires .NET Framework 1.1.