Microsoft KB Archive/259957

= Sample Outlook.prf file with Internet E-mail service options =

Article ID: 259957

Article Last Modified on 1/27/2007

-

APPLIES TO


 * Microsoft Outlook 2000 Standard Edition
 * Microsoft Outlook 98 Standard Edition
 * Microsoft Outlook 97 Standard Edition
 * Microsoft Exchange Server 5.5 Standard Edition

-



This article was previously published under Q259957



SUMMARY
When an administrator deploys Outlook, the administrator can configure Internet E-mail service for a user Messaging Application Programming Interface (MAPI) profile by using a Profile Descriptor File (.prf).

The Microsoft Office 2000 Resource Kit contains a sample Outlook.prf file with example Internet E-mail service options. The &quot;More Information&quot; section of this article contains the complete text of the Outlook.prf file that is included with the Resource Kit.



MORE INFORMATION
The Microsoft Exchange Automatic Profile Generator (Newprof.exe) reads a Profile Descriptor File (.prf), and then creates a profile based on the information in the file.

Newprof.exe version 5.5.2325 or later is required to create a MAPI profile with Internet E-mail service(s) for Outlook 98. Newprof.exe version 5.5.3121.0 (shipped with SR1a) or later is needed to create a MAPI profile with Internet E-mail service(s) for Outlook 2000. The Microsoft IExpress Deployment Kit contains Newprof.exe version 5.5.2803. For additional information about the IExpress Deployment Kit, click the following article number to view the article in the Microsoft Knowledge Base:

237803 Updated version of the IExpress Deployment Kit available

Contents of the sample Outlook.prf file:

=
==================== [General] Custom=1 ProfileName=Microsoft Outlook DefaultProfile=Yes OverwriteProfile=Yes DefaultStore=Service2 [Service List] Service1=Microsoft Outlook Client Service2=Microsoft Exchange Server Service3=Outlook Address Book Service4=Personal Folders Service5=Internet E-mail [Internet Account List] Account1=I_Mail [Service1] [Service2] ConversionProhibited=TRUE HomeServer= [Service3] Ben=TRUE [Service4] PathToPersonalFolders=c:\outlook.pst [Service5] AccountName=PopAccount ' The AccountName has to match the Account name in Section 5. LongAccountName=Internet E-mail - PopAccount [Account1] AccountName=PopAccount ConnectionType=1 POP3Server=MyPOPServer SMTPDisplayName=Someone SMTPEmailAddress=someone@microsoft.com SMTPOrgName=Personal SMTPServer=MySMTPServer [Microsoft Outlook Client] SectionGUID=0a0d020000000000c000000000000046 FormDirectoryPage=PT_STRING8,0x0270 WebServicesLocation=PT_STRING8,0x0271 ComposeWithWebServices=PT_BOOLEAN,0x0272 PromptWhenUsingWebServices=PT_BOOLEAN,0x0273 OpenWithWebServices=PT_BOOLEAN,0x0274 [Microsoft Exchange Server] ServiceName=MSEMS MDBGUID=5494A1C0297F101BA58708002B2A2517 MailboxName=PT_STRING8,0x6607 HomeServer=PT_STRING8,0x6608 OfflineFolderPath=PT_STRING8,0x6610 OfflineAddressBookPath=PT_STRING8,0x660E ExchangeConfigFlags=PT_LONG,0x6601 ConversionProhibited=PT_BOOLEAN,0x3A03 [Microsoft Mail] ServiceName=MSFS ServerPath=PT_STRING8,0x6600 Mailbox=PT_STRING8,0x6601 Password=PT_STRING8,0x67f0 RememberPassword=PT_BOOLEAN,0x6606 ConnectionType=PT_LONG,0x6603 UseSessionLog=PT_BOOLEAN,0x6604 SessionLogPath=PT_STRING8,0x6605 EnableUpload=PT_BOOLEAN,0x6620 EnableDownload=PT_BOOLEAN,0x6621 UploadMask=PT_LONG,0x6622 NetBiosNotification=PT_BOOLEAN,0x6623 NewMailPollInterval=PT_STRING8,0x6624 DisplayGalOnly=PT_BOOLEAN,0x6625 UseHeadersOnLAN=PT_BOOLEAN,0x6630 UseLocalAdressBookOnLAN=PT_BOOLEAN,0x6631 UseExternalToHelpDeliverOnLAN=PT_BOOLEAN,0x6632 UseHeadersOnRAS=PT_BOOLEAN,0x6640 UseLocalAdressBookOnRAS=PT_BOOLEAN,0x6641 UseExternalToHelpDeliverOnRAS=PT_BOOLEAN,0x6639 ConnectOnStartup=PT_BOOLEAN,0x6642 DisconnectAfterRetrieveHeaders=PT_BOOLEAN,0x6643 DisconnectAfterRetrieveMail=PT_BOOLEAN,0x6644 DisconnectOnExit=PT_BOOLEAN,0x6645 DefaultDialupConnectionName=PT_STRING8,0x6646 DialupRetryCount=PT_STRING8,0x6648 DialupRetryDelay=PT_STRING8,0x6649 [Personal Folders] ServiceName=MSPST MS PathToPersonalFolders=PT_STRING8,0x6700 RememberPassword=PT_BOOLEAN,0x6701 EncryptionType=PT_LONG,0x6702 Password=PT_STRING8,0x6703 [Outlook Address Book] ServiceName=CONTAB Ben=PT_STRING8,0x6700 [Microsoft LDAP Directory] ServiceName=EMABLT LDAPServer=PT_STRING8,0x6600 LDAPServerPort=PT_STRING8,0x6601 UserName=PT_STRING8,0x6602 SearchBase=PT_STRING8,0x6603 SearchFilter=PT_STRING8,0x6604 MAPIAddressType=PT_STRING8,0x6605 EMailAttribute=PT_STRING8,0x6606 LDAPTimeLimit=PT_STRING8,0x6607 LDAPSizeLimit=PT_STRING8,0x6608 LDAPTimeLimitLowBand=PT_STRING8,0x6609 LDAPSizeLimitLowBand=PT_STRING8,0x660a LogFilePath=PT_STRING8,0x660b ErrorLogging=PT_STRING8,0x660c DisplayNameSource=PT_STRING8,0x6611 DisplayFailDialog=PT_STRING8,0x6612 [Internet E-Mail] ServiceName=IMAIL AccountName=PT_STRING8,0x661f LongAccountName=PT_STRING8,0x3001 [I_Mail] AccountName=PT_STRING8,0x1235 ConnectionType=PT_DWORD,0x1239 Connectoid=PT_STRING8,0x123A POP3Server=PT_STRING8,0x13C4 POP3UseSicily=PT_BOOLEAN,0x13C8 POP3LogonName=PT_STRING8,0x13C5 POP3Port=PT_DWORD,0x13C9 POP3SSL=PT_BOOLEAN,0x13CA POP3TimeOut=PT_DWORD,0x13CB POP3LeaveOnServer=PT_BOOLEAN,0x13CC POP3RemoveExpired=PT_BOOLEAN,0x13CE POP3ExpireDays=PT_DWORD,0x13CF POP3RemoveDeleted=PT_BOOLEAN,0x13CD SMTPServer=PT_STRING8,0x1428 SMTPUseSicily=PT_DWORD,0x142C SMTPLogonName=PT_STRING8,0x1429 SMTPPort=PT_DWORD,0x142D SMTPSSL=PT_BOOLEAN,0x142E SMTPTimeOut=PT_DWORD,0x142F SMTPDisplayName=PT_STRING8,0x1430 SMTPOrgName=PT_STRING8,0x1431 SMTPEmailAddress=PT_STRING8,0x1432 SMTPReplyAddress=PT_STRING8,0x1433 SMTPSplitMessages=PT_BOOLEAN,0x1434 SMTPSplitSize=PT_DWORD,0x1435
 * Sample PRF file for creating Outlook profiles in Corporate or Workgroup configuration
 * Copyright (C), Microsoft Corporation, 1997-1999.
 * The following PRF file is included as an example of how to create a PRF file that will
 * configure a profile with the following services: Microsoft Exchange Server, Outlook
 * Address Book, Personal Folders, and Internet E-mail (POP3). Sections 1 through 5 may;
 * be modified; DO NOT MODIFY SECTIONS 6 and 7. It will most likely prevent the profile
 * from being properly created Be very careful when editing to ensure property values
 * match their property types.
 * Note that sections 2 and 3 are similar. Section 2 determines the kind and number
 * of MAPI services, while section 3 determines the number of accounts. Sections 4 and
 * 5 are also similar. Section 4 determines specific settings for each MAPI service,
 * while section 5 determines specific settings for Internet Accounts. Finally, sections
 * 6 and 7 are also similar; they display the possible settings for MAPI services and
 * Internet Accounts, respectively.
 * Section 1 - Profile defaults.
 * Internet Accounts, respectively.
 * Section 1 - Profile defaults.
 * Section 1 - Profile defaults.
 * -- Required. Indicates that this is a customized PRF file.
 * Section 2 - Services in profile.
 * The list of MAPI services that will be added to the profile.
 * The list of MAPI services that will be added to the profile.
 * The list of MAPI services that will be added to the profile.
 * If you add an Internet E-mail service, you also have to add an Account in
 * section 3.
 * Section 3 - List of internet accounts.
 * The list of accounts that will be created.
 * The list of accounts that will be created.
 * The list of accounts that will be created.
 * Section 4 - Default values for each service.
 * Section 4 - Default values for each service.
 * No settings configured.
 * Required.
 * -- The name of the Microsoft Exchange Server the user should
 * connect to. You can specify any Microsoft Exchange Server
 * in your site, and the correct Home Server will be assigned;
 * when the user first logs on.
 * -- Dummy property.  Do not delete or modify.
 * The directories in the path to the personal folders must already exist
 * The LongAccountName always has to be &quot;Internet E-mail -&quot; + + AccountName
 * Section 5 - Values for each internet account.
 * The settings for each account that will be created. The available
 * account settings are listed in Section 3, below.
 * The settings for each account that will be created. The available
 * account settings are listed in Section 3, below.
 * This is an example of a POP3 account
 * Section 6 - Mapping for profile properties. DO NOT MODIFY.
 * Outlook settings stored in the profile
 * Outlook settings stored in the profile
 * Outlook settings stored in the profile
 * Outlook settings stored in the profile
 * -- The URL of Exchange Web Services Form Directory page used to
 * create Web forms.
 * -- The URL of Exchange Web Services page used to display
 * unknown forms.
 * -- Set to TRUE to use Exchange Web Services to compose forms.
 * -- Set to TRUE to use Exchange Web Services to display unknown
 * forms.
 * -- Set to TRUE to prompt user before opening unknown forms when
 * using Exchange Web Services.
 * Microsoft Exchange Server service definitions.
 * Microsoft Exchange Server service definitions.
 * -- The name of the user's Exchange Server Mailbox
 * -- The name of the Microsoft Exchange Server the user should
 * connect to. You can specify any Microsoft Exchange Server
 * in your site, and the correct Home Server will be assigned;
 * when the user first logs on.
 * -- The path to the Offline Store File that contains
 * local replicas of the user's Mailbox and Favorites.
 * If you do not specify a value, no Offline Store will
 * be created. If you specify a path, an Offline Store
 * will be created and the Inbox, Outbox, Deleted Items,
 * and Sent Items folders will be replicated to it.
 * -- The path to the directory to store offline address
 * book files in.
 * -- Behavior when connecting to the Exchange Server.
 * 32 - Auto detect online/offline connection state (default)
 * 48 - Always connect online
 * 50 - Prompt user for online or offline connection
 * -- A boolean value indicating whether NEWPROF should
 * attempt to resolve the Exchange mailbox name at run time.
 * If set to TRUE, NEWPROF will copy the name to the profile
 * without resolving it.
 * If FALSE, the name will be resolved. Invalid server or
 * mailbox name will not be copied to the profile.
 * Microsoft Mail service definitions.
 * Microsoft Mail service definitions.
 * -- The path to the users post office.  Mapped network drives, UNC and NETWARE paths
 * are acceptable. NETWARE paths of the type NWServer/share:dir\dir1 are converted to
 * UNC paths of the type \\NWServer\share\dir\dir1.
 * -- The users mailbox name.  eg. in a NET/PO/USER address,
 * this is USER. The maximum mailbox name is 10 characters.
 * -- The users mailbox password.  The maximum password is 8 characters.
 * -- A boolean value indicating whether the users password is
 * to be remembered in the profile or not. This is useful because
 * if the password is remembered the user can bypass the logon prompt
 * if his server path, mailbox name and password are all supplied.
 * -- The connection type.  This may be one of CFG_CONN_AUTO, CFG_CONN_LAN,
 * CFG_CONN_REMOTE, CFG_CONN_OFFLINE as defined below.
 * 0x0        --  LAN type connection.  Used to connect to the post office using a
 * UNC path or pre-existing mapped drive.
 * 0x1        --  Dial up connection using Dial-up Networking.
 * 0x2        --  Not connected.
 * 0x3        --  Automatically detect whether the connection type is LAN or REMOTE.
 * This connection type is only available on Win95.
 * This connection type is only available on Win95.
 * -- A boolean value indicating whether session logging
 * is on or off.
 * -- The path to the session log file.
 * -- A boolean value which indicates whether mail in the outbox
 * is sent.
 * -- A boolean value which indicates whether mail in the server
 * mailbag is downloaded.
 * -- A bit array which allows the user to indicate which addresses
 * for which the transport is to attempt delivery. This is useful
 * in order to allow a user to specify that a transport only handle
 * delivery for a subset of the addresses it can really process.
 * When multiple transports are installed and the user wants a
 * different transport to handle some specific address types they
 * can use this bit array to specify that the MSMAIL transport
 * only handle a specific set of addresses.
 * Possible values as defined below include:
 * 0x00000001     --  Local Post Office and External Post Office address types
 * 0x00000002     --  PROFS address types
 * 0x00000004     --  SNADS address types
 * 0x00000008     --  MCI address types
 * 0x00000010     --  X.400 address types
 * 0x00000040     --  FAX address types
 * 0x00000080     --  MHS address types
 * 0x00000100     --  SMTP address types
 * 0x00000800     --  OfficeVision address types
 * 0x00001000     --  MacMail address types
 * 0x000019df     --  All of the above address types
 * 0x00001000     --  MacMail address types
 * 0x000019df     --  All of the above address types
 * -- A boolean value which indicates whether a netbios notification
 * is sent to a recipients transport when mail is delivered to
 * their server inbox.
 * -- The polling interval in minutes when the transport
 * checks for new mail. 1 <= polling interval <= 9999
 * -- A boolean value which, if TRUE, only displays the Microsoft Mail Global Address
 * list for name selection. The Postoffice list, external post office lists, and gateway
 * address lists are not shown.
 * -- A boolean value which indicates whether the user wants to enable
 * headers while working on the LAN. Headers mode allows the user
 * to download message headers and selectively choose which mail
 * to download.
 * -- A boolean value which indicates whether the user wants to use
 * name resolution based on a local copy of the server address book
 * rather than the server address book itself.
 * -- A boolean value which indicates whether EXTERNAL.EXE, a server process, should be used
 * to deliver submitted mail messages. This is sometimes useful when mail is running
 * on a slow LAN connection.
 * -- A boolean value which indicates whether the user wants to enable
 * headers while working over a slow speed link. Headers mode
 * allows the user to download message headers and selectively
 * choose which mail to download.
 * -- A boolean value which indicates whether the user wants to use
 * name resolution based on a local copy of the server address book
 * rather than the server address book itself.
 * -- A boolean value which indicates whether EXTERNAL.EXE, a server process, should be used
 * to deliver submitted mail messages. This speeds up message delivery when mail is
 * running on a Dial-up network connection.
 * -- A boolean value which indicates that a Dial-up Network connection should
 * be established when the transport provider starts up.
 * -- A boolean value which indicates that a Dial-up Network connection should
 * be automatically terminated when headers are finished downloading.
 * -- A boolean value which indicates that a Dial-up Network connection should
 * be automatically terminated after mail has finished being sent
 * received.
 * -- A boolean value which indicates that a Dial-up Network connection should
 * be automatically terminated when the provider is exited.
 * -- The name of the Dial-up Network profile that the transport will use by
 * default to attempt the connection.
 * -- Number of times to attempt dial for connection.
 * 1 <= retry attempts <= 9999
 * -- Delay between retry attempts in seconds.
 * 30 <= retry delay <= 9999
 * Personal Folders service definitions.
 * Personal Folders service definitions.
 * -- Path to personal folders.
 * -- A boolean value that determines if the personal folders password
 * should be cached.
 * -- A value that designates the type of encryption that is used to
 * compress the data in the PST:
 * No Encryption             0x80000000
 * Compressable Encryption   0x40000000
 * Best Encryption           0x20000000
 * Best Encryption           0x20000000
 * -- PST password.
 * Outlook Address Book service definitions.
 * Outlook Address Book service definitions.
 * -- Dummy property.  Do not modify.
 * Microsoft LDAP Directory service definitions.
 * Microsoft LDAP Directory service definitions.
 * -- This is the IP address or host name of the machine containing
 * the LDAP server.
 * -- The port number that the LDAP server is listening on.
 * -- Enter the user's name. This value is not required if you allow
 * anonymous binds.
 * -- The Search Base (e.g. o=microsoft, c=US).
 * -- The Search Filter in RFC1777 format with %s allowed as a
 * substitution token for the name to be searched for. For example,
 * (|(cn=*%s*)(sn=*%s*)) can be used to perform a search on common name
 * or surname.
 * -- The address type to be used by MAPI in message submission. For
 * example, SMTP.
 * -- The E-Mail Attribute (e.g. mail, mhsOrAddresses or
 * rfc822Mailbox), which is mapped to the MAPI PR_EMAIL_ADDRESS property.
 * -- LDAP Time Limit for searching (in seconds). The maximum length of
 * time to search the directory. A value of 0 means that the search will
 * not be limited by time. Note that this will not necessarily supersede
 * any system-wide limits defined on the server.
 * -- LDAP Size limit for searching (in number of 'hits'). The maximum
 * number of matches to return. A value of 0 means that there is no
 * limit to the number of matches. Note that this will not necessarily
 * supersede any system-wide limits defined on the server.
 * -- Same as LDAP Time Limit, except for low bandwidth links.
 * -- Same as LDAP Size Limit, except for low bandwidth links.
 * -- Log File (full pathname).
 * -- Error Logging Levels, ON or OFF.
 * -- Attribute to be used within the Internet Directory entry for
 * populating the user Display Name.
 * -- Attribute to determine if a dialog will be displayed when a search
 * to the Internet Directory fails. The dialog will display additional
 * information. Values can be either 1 (display) or 0 (do not display).
 * If you configure an Internet E-mail service, then you also need to add
 * information in section 5.
 * When creating an Internet E-Mail service, both AccountName and
 * LongAccountName MUST BE specified!
 * This should be exactly the same as the I_Mail AccountName
 * property.
 * This should be the &quot;Internet E-mail - &quot; + the AccountName
 * property. For example, if AccountName=&quot;foo&quot;, then this
 * should be &quot;Internet E-mail - foo&quot;.
 * Section 7 - Mapping for internet account properties. DO NOT MODIFY.
 * Internet E-Mail service Settings/Definitions
 * In a Corporate or Workgroup configuration, the only type of account that
 * can be created is an I_MAIL (POP3) account. You can use settings from
 * the [I_Mail] section below.
 * can be created is an I_MAIL (POP3) account. You can use settings from
 * the [I_Mail] section below.
 * *** Mail Account Settings ***
 * Configurable settings for POP3 (Corporate and Intenet Only configs)
 * and IMAP (Internet Only config only) mail accounts
 * Configurable settings for POP3 (Corporate and Intenet Only configs)
 * and IMAP (Internet Only config only) mail accounts
 * The name of the account that appears in the Account List.
 * Values:
 * 0 = Connect using local area network (LAN).
 * 1 = Connect using Internet Explorer's or a 3rd party dialer.
 * 2 = Connect using modem and the Dial-up Networking connection
 * specified in the Connectoid property.
 * Specify the existing Dial-up Networking connection to use.
 * --- POP3 Account Settings ---
 * --- POP3 Account Settings ---
 * Specifies the name of the POP3 server used for incoming messages.
 * Set to 1 if you want to use Secure Password Authentication to logon
 * to the POP3 server.
 * If POP3UseSicily is turned on, this sets the name used to logon
 * to the POP3 server.
 * Specfies the port number used to connect to the POP3 server.
 * Set to 1 to use the SSL (Secure Sockets Layer) security protocal to
 * connect to the POP3 server.
 * Specifies how long to wait for a response for the server before
 * stopping to attempt to send or receive messages. Possible values:
 * 30 = 30 seconds
 * 60 = 1 minute
 * 90 = 1 minute 30 seconds
 * 120 = 2 minutes
 * 150 = 2 minutes 30 seconds
 * 180 = 3 minutes
 * 210 = 3 minutes 30 seconds
 * 240 = 4 minutes
 * 270 = 4 minutes 30 seconds
 * 300 = 5 minutes
 * Set to 1 to store a copy of all sent and received messages on the
 * POP3 server.
 * If POP3LeaveOnServer is turned on, set to 1 to delete messages on
 * the server after a specific number of days (see also
 * POP3ExpireDays).
 * If POP3LeaveOnServer and POP3RemoveExpired are turned on, sets
 * the number of days after which messages left on the server will
 * be deleted.
 * This property is only supported on Outlook 98 (8.5)or higher! If
 * you try to use it on Outlook 97 (8.0x) the account will not be
 * created.
 * If POP3LeaveOnServer is turned on, set to 1 to delete a message
 * from the server when the message is deleted from the Deleted
 * Items folder on the local machine.
 * --- SMTP Account Settings ---
 * --- SMTP Account Settings ---
 * Specifies the name of the SMTP server used for outcoming messages.
 * Values:
 * 0 = No server authentication required.
 * 1 = Use Secure Password Authentication, or set SMTP server logon
 * name using SMTPLogonName.
 * If SMTPUseSicily is set to 1, this sets the name used to logon to
 * the SMTP server.
 * Specfies the port number used to connect to the SMTP server.
 * Set to 1 to use the SSL (Secure Sockets Layer) security protocal to
 * connect to the SMTP server.
 * Specifies how long to wait for a response for the server before
 * stopping to attempt to send or receive mail messages. Values are
 * the same as POP3TimeOut.
 * Specifies the &quot;friendly&quot; name associated with the email address.
 * Specifies the group or organization.
 * Specifies the email address. Must be in the format name@company
 * Specifies that replies to outgoing email should be sent to this
 * email address.
 * This property is only supported on Outlook 98 (8.5) or higher! If
 * you try to use it on Outlook 97 (8.0x) the account will not be
 * created.
 * Set to 1 to break up outgoing messages, so that each message is
 * smaller than the file size indicated by SMTPSplitSize.
 * The maximum size, in KB, of a piece of a split message.

