wsreg_add_display_name(3WSREG)			    Product Install Registry Library Functions			    wsreg_add_display_name(3WSREG)

NAME

       wsreg_add_display_name, wsreg_remove_display_name, wsreg_get_display_name, wsreg_get_display_languages - add, remove, or return a localized
       display name

SYNOPSIS

       cc [flag ...]  file ...-lwsreg [library ...]
       #include <wsreg.h>

       int wsreg_add_display_name(Wsreg_component *comp, const char *language, const char *display_name);

       int wsreg_remove_display_name(Wsreg_component *comp, const char *language);

       char *wsreg_get_display_name(const Wsreg_component *comp, const char *language);

       char  **wsreg_get_display_languages(const Wsreg_component *comp);

DESCRIPTION

       For each of these functions, the comp argument specifies the component on which these functions operate. The language argument is  the  ISO
       639 language code identifying a particular display name associated with the specified component.

       The wsreg_add_display_name() function adds the display name specified by display_name to the component specified by comp.

       The wsreg_remove_display_name() function removes a display name from the component specified by comp.

       The wsreg_get_display_name() function returns a display name from the component specified by comp.

       The  wsreg_get_display_languages() returns the ISO 639 language codes for which display names are available from the component specified by
       comp.

RETURN VALUES

       The wsreg_add_display_name() function returns a non-zero value if the display name was set correctly; otherwise 0 is returned.

       The wsreg_remove_display_name() function returns a non-zero value if the display name was removed; otherwise 0 is returned.

       The wsreg_get_display_name() function returns the display name from the specified component if the component has a  display  name  for  the
       specified language code. Otherwise, NULL is returned.  The caller must not free the resulting display name.

       The  wsreg_get_display_languages() function returns a null-terminated array of ISO 639 language codes for which display names have been set
       into the specified component.  If no display names have been set, NULL is returned.  It is  the	caller's  responsibility  to  release  the
       resulting array, but not the contents of the array.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Unsafe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       wsreg_initialize(3WSREG), attributes(5)

SunOS 5.10							    22 Sep 2000 				    wsreg_add_display_name(3WSREG)