SetSessionID

Sets the session ID stored in the DEVMODE of the printer driver. This session ID will be used in the message interface name on terminal servers. For example \\.\pipe\ColorMessageInterface2. The 2 is the used session ID.

This value is ignored if the UseWindowsSessionID property is set to TRUE.

Boolean SetSessionID(pDevMode As Long, Long lSessionID)

Only used on Windows Server systems.

This function can be used to specify the session ID manually. This is for advanced users only. Changing this value is not recommended unless it is your application that does the printing and you can guarantee that your application is using a DEVMODE structure that contains the updated value (I.e.: you print using GDI from C++ and you change this value directly in the DEVMODE structure that is used throughout your application and passed into CreateDC). By setting the session ID to a unique value in your application you can restrict the messaging interface so you only receive messages about print jobs that where printed from your application.

If you want to make sure every application is using the same value, you should change the SessionID and UseWindowsSessionID keys in the printer driver INI files before installation.

 

Input value   - handle to the BlackIceDEVMODE structure

Input value   - session ID to set. This value must be a positive integer value

Return value            - TRUE on success, otherwise FALSE