SetCustomStartApplicationParameter

#include “BlackIceDEVMODE.h”

 

Void  SetCustomStartApplicationParameter (BlackIceDEVMODE* pDevMode, LPCWSTR CustomStartApplicationParameter);

Description

Sets the value of the custom start parameter, which can be any string up to 1024 characters in length.

Parameters

BlackIceDEVMODE* pDevMode                                       - pointer to the BlackIceDEVMODE structure

LPCWSTR CustomStartApplicationParameter              - string containing the text to be passed

Return value

None

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