VistaIOSetProgramName3

Usage

void VistaIOSetProgramName (name)
VistaIOStringConst name

Arguments

name

Specifies the program's name as a null-terminated string, or is NULL to indicate that no program name should be registered.

Overview

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

int main (argc, argv)
int argc;
char *argv[];
{
	...
	VistaIOSetProgramName (argv[0]);
	...
}

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.