VendorSetup

VendorSetup = filename, function-name

Names a vendor-provided Win32 DLL that performs a custom installation step after the normal installation process is successfully completed.

filename

Name of the vendor-supplied DLL that performs the extra installation step.

function-name

Name of the function exported by the DLL to call to begin the vendor-supplied installation step.


Use of a VendorSetup statement in the Install section or a Data section it refers to indicates that the printer vendor has a custom installation step to perform after normal printer installation is successfully completed. Note that the custom installation step DLL will never be called if the normal installation process does not go to successful completion.

The vendor-supplied DLL must be a Win32 DLL and the function identified by function-name must have the following prototype:


VOID FAR PASCAL functionname (HWND      hWnd,
                              HINSTANCE hInstance,
                              LPSTR     lpszCmdLine,
                              int       nCmdShow
                             );

When the normal installation process calls the exported function, lpszCmdLine points to user-displayable (friendly) name of the printer that has just been installed. The vendor DLL can use that printer name as a parameter in Win32 print subsystem functions to obtain all necessary printer and driver information about the installed printer.

If a VendorSetup statement is used in the Install section (or a Data section it refers to), then Windows 95 will not prompt the user with the opportunity to print a test page at the end of the printer installation.