wsreg_get_unique_name(3wsreg) [sunos man page]

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

NAME

       wsreg_set_unique_name, wsreg_get_unique_name - set or get the unique name of a component

SYNOPSIS

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

       int wsreg_set_unique_name(Wsreg_component *comp, const char *unique_name);

       char *wsreg_get_unique_name(const Wsreg_component *comp);

DESCRIPTION

       The  wsreg_set_unique_name()  function  sets  the unique name specified by unique_name in the component specified by comp.  Every component
       must have a unique name before being registered.  If a unique name has already been set in the specified component, the	resources  associ-
       ated with the previously set unique name are released.

       The  wsreg_get_unique_name()  function  gets  the  unique  name	string from the component specified by comp.  The resulting string must be
       released by the caller.

RETURN VALUES

       The wsreg_set_unique_name() function returns a non-zero value if the unique name was set correctly; otherwise it returns 0.

       The wsreg_get_unique_name() function returns a copy of the unique name from the specified component.

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_set_unique_name(3WSREG)

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

NAME

       wsreg_create_component, wsreg_free_component, wsreg_free_component_array - create or release a component

SYNOPSIS

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

       Wsreg_component *wsreg_create_component(const char *uuid);

       void wsreg_free_component(Wsreg_component *comp);

       int wsreg_free_component_array(Wsreg_component **complist);

DESCRIPTION

       The wsreg_create_component() function allocates a new component and assigns the uuid (universal unique identifier) specified by uuid to the
       resulting component.

       The wsreg_free_component() function releases the memory associated with the component specified by comp.

       The wsreg_free_component_array() function frees the null-terminated array of component pointers specified by complist.  This  function  can
       be used to free the results of a call to wsreg_get_all(). See wsreg_get(3WSREG).

RETURN VALUES

       The wsreg_create_component() function returns a pointer to the newly allocated Wsreg_component structure.

       The  wsreg_free_component_array()  function returns a non-zero value if the specified Wsreg_component array was freed successfully.  Other-
       wise, 0 is returned.

USAGE

       A minimal registerable Wsreg_component configuration must include a version, unique name, display name, and an install location.

ATTRIBUTES

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

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

SEE ALSO

       wsreg_add_display_name(3WSREG), wsreg_get(3WSREG), wsreg_initialize(3WSREG), wsreg_register(3WSREG), wsreg_set_id(3WSREG),  wsreg_set_loca-
       tion(3WSREG), wsreg_set_unique_name(3WSREG), wsreg_set_version(3WSREG), attributes(5)

SunOS 5.10							    22 Sep 2000 				    wsreg_create_component(3WSREG)