VistaIOSetProgramName - register a program name for error messages
Contents
Arguments
name Specifies the program's name as a null-terminated string, or is NULL to indicate that no
program name should be registered.
Description
VistaIOSetProgramName determines what, if any, program name will be included in subsequent error messages
composed by VistaIOError (3), VistaIOSystemError(3), VistaIOWarning(3), and VistaIOSystemWarning(3).
Initially, no program name is registered. If VistaIOSetProgramName is called with a string, that string
is registered as the program name. If VistaIOSetProgramName is called with an argument of NULL, any
previously-registered name is forgotten.
Examples
intmain(argc,argv)intargc;char*argv[];{
...
VistaIOSetProgramName(argv[0]);
...
}Name
VistaIOSetProgramName - register a program name for error messages
Notes
VistaIOSetProgramName does not make its own copy of the string it is passed. Consequently, storage used
for the string must be maintained by the caller.
See Also
VistaIOError(3), VistaIOWarning(3), VistaIOSetErrorHandler(3), VistaIOSetWarningHandler(3),
Synopsis
voidVistaIOSetProgramName(name)VistaIOStringConstname
