SunOS man pages


	www.sun.com	docs.sun.com \| \| \|

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 Functions

wsreg_can_access_registry(3WSREG)

DESCRIPTION
RETURN VALUES
EXAMPLES
USAGE
ATTRIBUTES
SEE ALSO

NAME

wsreg_can_access_registry - determine access to product install registry

SYNOPSIS

cc [flag ...] file ...-lwsreg [library ...] #include <fcntl.h> #include <wsreg.h> int wsreg_can_access_registry(int access_flag);

DESCRIPTION

The wsreg_can_access_registry() function is used to determine what access, if any, an application has to the product install registry.

The access_flag argument can be one of the following:

O_RDONLY: Inquire about read only access to the registry.
O_RDWR: Inquire about modify (read and write) access to the registry.

RETURN VALUES

The wsreg_can_access_registry() function returns non-zero if the specified access level is permitted. A return value of 0 indicates the specified access level is not permitted.

EXAMPLES

Example 1. Initialize the registry and determine if access to the registry is permitted.

#include <fcntl.h>
#include <wsreg.h>

int main(int argc, char **argv)
{
    int result;
    if (wsreg_initialize(WSREG_INIT_NORMAL, NULL)) {
        printf("conversion recommended, sufficient access denied\n");
    }

    if (wsreg_can_access_registry(O_RDONLY)) {
        printf("registry read access granted\n");
    } else {
        printf("registry read access denied\n");
    }

    if (wsreg_can_access_registry(O_RDWR)) {
        printf("registry read/write access granted\n");
    } else {
        printf("registry read/write access denied\n");
    }
}

USAGE

The wsreg_initialize(3WSREG) function must be called before calls to wsreg_can_access_registry() can be made.

ATTRIBUTES

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
MT-Level	Unsafe