BCL easyPDF SDK
easyPDF SDK Usermanual
PDF Creator Programming API  |  Download Free Trial  |  Contact Us to Purchase

InteractiveUserSession Property

Deprecated. Gets/Sets the flag to indicate whether to launch Microsoft Word as an interactive user when printing from a service or server under Windows Vista, 7, 8, Windows Server 2008 or 2012.

Type

Boolean

Default Value

Auto-detected (False for Word 2010 and 2013, True otherwise)

Attention

This property has been deprecated, because easyPDF SDK can auto-detect the optimum value. Due to Microsoft's security implementation in Windows Vista, 7, 8, Server 2008 and 2012, when using WordPrintJob, Microsoft Word 2003 and 2007 cannot run directly from a server or a service without launching as an interactive user under the listed operating systems. Microsoft Word 2010 and 2013 do not have this problem.

Description

Beginning with Windows Vista, when using WordPrintJob, Microsoft Word 2003 and 2007 can not be run directly from a server or a service. It will only work when launched as an interactive user. That means an actual user (such as easyPDF8User) needs to be physically logged on to the system at all times, or else the PDF conversion is going to fail.

For proper operation please make sure not to set the InteractiveUserSession property. It is automatically set to True for Word 2003 and 2007, and False for Word 2010 and 2013. This gives the most desired behavior.

If you explicitly force InteractiveUserSession to True, an interactive user must always be logged on, even in Word 2010 and 2013. If you explicitly force InteractiveUserSession to False, printing will time out or freeze permanently with Word 2003 and 2007. If you ignore InteractiveUserSession and never set it to any value, it is automatically set to its optimum value (True for Word 2007 and older, False for Word 2010 and newer).

Note that it is highly unconventional for a server to require an interactive user to be logged on at all times. However, due to restrictions in Vista and Microsoft Word 2007 and older, when using WordPrintJob an interactive user is necessary.

Who Is Affected?

Only customers using WordPrintJob to print Microsoft Word documents under Windows Vista, 7, 8, Windows Server 2008 or 2012 with Word 2000, 2002, 2003, and 2007 from a System Service, a Web Server, or a Web Service are affected.

Workaround

If you find these Microsoft Word limitations unacceptable, please consider upgrading to Word 2010 or 2013, or downgrading to Windows 2003 Server. That way you can avoid having to be logged on as an interactive user.

Alternatively, you may consider using WordPrintJobEx instead, as it does not require an interactive user to be logged on. Be aware that WordPrintJobEx requires Word 2013, 2010, or Word 2007 plus the free "Save as PDF or XPS" add-in from Microsoft.

Summary

Behavior when using WordPrintJob:

Operating System Microsoft Word Action Needed
Windows XP
Windows Server 2003
All versions of Word Ignore InteractiveUserSession. User is not required to be logged on.
Windows Vista, 7, 8
Windows Server 2008, 2012
Word 2003, 2007 Set InteractiveUserSession = True, or leave it at its default value. Interactive user must be logged on at all times.
Word 2010, 2013 Set InteractiveUserSession = False, or leave it at its default value. User is not required to be logged on.

Example Usage

Set oLoader = Server.CreateObject("easyPDF.Loader.8")
Set oPrinter = oLoader.LoadObject("easyPDF.Printer.8")

Set oPrintJob = oPrinter.WordPrintJob
oPrintJob.InteractiveUserSession = True ' Not recommended to be set anymore
oPrintJob.PrintOut "C:\test\input.doc", "C:\test\output.pdf"