Groupwise Developer's Guide

34
ConvertEmailAddress (OldAddress, [Format]). This method takes an address,
specified as either a string or an Address object, and converts it into a new format
specified by Format. It returns the address string with the new format. The format
is an enumerated value specified by the EmailAddressFormatConstants. Both the
constants and the method are new to GroupWise 5.5.
Some Newer Methods
For GroupWise 6.0 SP1, and GroupWise 5.5 EP SP4 and later versions, there are
three new methods available at customer request. Here is a description of these
new methods.
SetPassword (OldPassword, NewPassword). Many GroupWise developers have
wanted for some time to be able to change their own password by using the Object
API. Up until now, this has been possible through the GroupWise Client, but not
through the Object API. This new method fulfills this need.
The first argument to SetPassword is simply the old password specified as a
string. The second argument is the desired new password, also specified as a
string. If the old password is incorrect, an error will result. Hence, you must know
your old password to change it. If the GroupWise account had no password, then
the OldPassword should be an empty string. Otherwise an error will occur.
Note that this method does not change the user’s NetWare, Windows, LDAP or
other passwords. It changes only the password associated with the current
GroupWise database.
SetPassword (“OldPsWrd”, “NewPsWrd”)
SynchronizeToRemote (path, masterPassword, isCache, flags). This new
method performs the equivalent of the regular client’s “Hit the Road”
functionality. Here is a description of the different arguments.
Name Data Type Description
path String This is the desired name for the remote
mailbox or the client cache mailbox.
MasterPassword String The user’s main mailbox password.
isCache Boolean Indicates if the call is setting up regular
remote or client cache.
flags Enumerated Integer The flags indicate what is to be downloaded.
(See the new SynchronizeConstants.)
www.novell.com/appnotes