GetCustomStartApplicationParameter

#include “BlackIceDEVMODE.h”

 

BOOL  GetCustomStartApplicationParameter (BlackIceDEVMODE* pDevMode, LPTSTR pValue, DWORD* pSize);

Description

Returns the value of the custom command line parameter for the application in the buffer specified by the pValue parameter. If the pValue parameter is NULL, the required buffer size in bytes is returned in the pSize parameter. The maximum string size allowed by the printer driver is 1024 characters.

Parameters

BlackIceDEVMODE* pDevMode               - pointer to the BlackIceDEVMODE structure

LPTSTR pValue                                           - pointer to the string

DWORD* pSize                                            - pointer to a variable that contains the length of pValue in bytes.

 

Return value

TRUE on success, otherwise FALSE.

Programming Notes

If the length of the string is longer than 63 characters, the string is stored in the registry (in HKEY_CURRENT_USER), otherwise it is stored in the BlackIceDEVMODE structure. This means that the value cannot be longer than 63 characters (64 with the ending \0 character) when the ClearUserSettings, ReplaceUserSettings and SaveDefaultBlackIceDEVMODE functions are used to set this value for every user.

To set a value to every user that is longer than 63 characters, a custom INI file must be used at installation.

When changing this value for the current user, the string can be longer than 63 characters but must be shorter than 1024 characters.

Code Example

None