Microsoft KB Archive/164728

= XFOR: Signup SSO Must Support Creating Mail Forwarding Records =

Article ID: 164728

Article Last Modified on 9/30/2003

-

APPLIES TO


 * Microsoft Commercial Internet System 1.0 Service Pack 2

-



This article was previously published under Q164728





SYMPTOMS
Microsoft Commercial Internet System customers are likely to setup two- tiered mail domain structures such as starlight.com and jp.starlight.com or us.starlight.com. To make this work, the Signup SSO must support creating routing table entries with forwarding records for the root domain (that is, starlight.com can forward to us.starlight.com or to jp.starlight.com).



CAUSE
Additional optional parameters were added to the SignUp SSO CreateUser function to handle the case of a forwarding mail record like domain.com. If the optional parameters are specified, the CreateUser function would make a series of calls to the POP3CreateUser function to set the forwarding e- mail records. If the optional parameters are specified, the CreateUser function would make a series of calls to the POP3CreateUser function to set the forwarding e-mail records.

This would mean changing the CreateUser parameter list to include optional parameters to specify the list of servers to set the forwarding record.



MORE INFORMATION
The parameter list for both CreateUser and POP3CreateUser are listed below:

SSO Function CreateUser
Required:

LPSTR strLoginName(A&A, POP3, IDS)

LPSTR strPassword(A&A)

LPSTR strEmailDomain(POP3,IDS)

LPSTR strEmailServer(POP3)

LPSTR strVRoot(POP3)

ULONG ulMailboxSize(POP3)

LPSTR strCountry(IDS)

LPSTR strOgranization(IDS)

Optional:

LPSTR strGivenName(IDS)

LPSTR strSurName(IDS)

ULONG ulAccount(GETPROP only. Not require input)

LPSTR strEMailRoot(POP3,IDS)

LPSTR strMailServerList (POP3)

SS0 Function Pop3CreateUser
Required:

wszServerName

wszEmail=A&A::szLoginName + wszDomainName

dwCreateMailbox=TRUE

dwMailboxSize

wszVRoot

Optional:

wszForwardEmail=NULL

First, CreateUser will call POP3CreateUser with 'strLoginName@stsrEmailDomain' as the value for wszEmail. This call would use the CreateUser strEmailServer, strVRoot, and ulMailboxSize parameters as the value for the POP3CreateUser wszServerName, wszVRoot, and dwMailboxSize parameters, respectively. The POP3CreateUser dwCreateMailbox parameter would be set to TRUE and the optional POP3CreateUser wszForwardEmail parameter would be set to NULL.

In CreateUser, the strMailServerList is a list of server names (separated by a space) and the strEMailRoot is the root e-mail address (that is, userid@domain.com). For each item in strMailServerList, CreateUser would make a call to POP3CreateUser with the CreateUser strEMailRoot parameter as the value for the POP3CreateUser wszEmail parameter and strLoginName + strDomainName as the value for the wszForwardEmail parameter. The POP3CreateUser dwCreateMailbox would be set to FALSE. Finally, if the CreateUser strEMailRoot address is specified, it will be used as the e- mail address put in IDS instead of strLoginName + strDomainName (that is, only one entry will be put in IDS).



STATUS
Microsoft has confirmed this to be a problem in Microsoft Commercial Internet System, version 1.0.

Keywords: kbbug KB164728

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.