Microsoft Identity Integration Server 2003 Developer Reference

ClearPasswordHistory Method of the MIIS_Server Class

The ClearPasswordHistory method removes password histories with a date and time that are earlier than the specified date and time. To use this method, you must be logged on as a member of the MIISAdmins security group. 
string ClearPasswordHistory(
  String EndingBefore
);

Parameters

EndingBefore
[in] The date and time string, in Coordinated Universal Time, of the most recent password history that will be deleted from the server. Password histories that are later than this specified date and time will be preserved.

Note  If you want to delete the password histories based on a local date and time, convert the local time to Coordinated Universal Time.

The format of this parameter is yyyy-MM-dd HH:mm:ss.fff.

Format specifier Description
yyyy Specifies the four-digit year
MM Specifies the two-digit month in the range of 1 to 12
dd Specifies the two-digit day of the month in the range of 1 to 31
HH Specifies the two-digit hour of the day in 24-hour format in the range of 0 to 23
mm Specifies the two-digit minute of the day in the range of 0 to 59
ss Specifies the two-digit second of the day in the range of 0 to 59
fff Specifies the three-digit fractions of a second in the range of 0 to 999

Note  To delete password histories by date only, omit the time units in the parameter.

Return Values

A string that contains the final status of the method. The return value can be one of the values listed in the Return Strings topic or one of the following values.
Return code Description
success The password change histories with end times that are earlier than the specified time were successfully deleted from the server.
access-denied The user that is running this method is not a member of the Microsoft Identity Integration Server 2003 security groups. Verify that the user is a member of one of these groups.
invalid-date-parameter The specified date is in the wrong format or password change histories do not exist for this date. Verify that the specified date is in the correct format.

Remarks

MIIS uses the password change history log to determine if the number of password changes that are requested in a 24-hour period exceeds the number that is specified in the management agent properties. When you successfully run this method, the history log is cleared and a new 24-hour period is started for the maximum number of password changes.

To clear the password change history log, run the MIIS_Server.ClearPasswordQueue method before running this method. If you run the MIIS_Server.ClearPasswordQueue method after running this method, any pending password change logs are then moved to the history log.

Requirements

Server: Requires Microsoft Identity Integration Server 2003 Service Pack 1.
Header: Declared in mmswmi.mof.


See Also

MIIS_Server, MIIS_Server.ClearPasswordQueue