Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
Product Install Registry Library Functionswsreg_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 TYPEATTRIBUTE VALUE
MT-LevelUnsafe

SEE ALSO

 

wsreg_initialize(3WSREG), attributes(5)


SunOS 5.9Go To TopLast Changed 22 Sep 2000

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.