ApplyProfileFile

 

#include “BlackIceDEVMODE.h”

 

BOOL            ApplyProfileFile (LPCTSTR szPrinterName, LPCTSTR szFileName, BlackIceDEVMODE* pDevmode);

Description

Applies the settings stored in the specified profile file without importing the profile to the printer driver. Registry settings are applied immediately, other settings are returned in the supplied BlackIceDEVMODE structure. Allocate a BlackIceDEVMODE structure using the LoadBlackIceDEVMODE function, retrieve the settings using ApplyProfileFile, save the settings using SaveBlackIceDEVMODE, and finally free the structure using the ReleaseBlackIceDEVMODE function.

 

For the detailed description please refer to the How to use the BlackiceDEVMODE.dll section.

Parameters

LPCTSTR szPrinterName             - name of the Black Ice printer.

LPCTSTR szFileName                  - path to the profile file.

BlackIceDEVMODE* pDevmode - the BlackIceDEVMODE structure that will receive the settings.

Return value

TRUE on success, otherwise FALSE.

Limitations

A 32 bit application that uses the 32 bit BlackIceDEVMODE.dll and ocx, must use the ApplyProfileFile function or method to change the profiles of 64 bit drivers. The rest of the Profile Manager Tab functions can only be used to change or retrieve the profiles of 32 bit drivers from 32 bit applications or to change or retrieve the profiles of 64 bit drivers from 64 bit applications.