sec_store_get()

Return a value that resides in the secure area of a PATROL Agent.

Syntax

sec_store_get(key)

Parameter

Description

The sec_store_get() function returns a value that has been stored in the Secure Key Store (SKS) archive. For more information about the SKS archive, see the PATROL Security User Guide. 

You can use the key parameter to specify which value you want to retrieve from the agent. The key that you use must be the same one that was used to store the value. When sec_store_get() completes successfully, it returns the value in plain text. If it is not successful, sec_store_get() returns the NULL string, "". For a complete list of error messages, see the following table. 

As a security feature, the sec_store_get() function cannot retrieve a value unless the application that calls sec_store_get() has the proper permissions. When a value is stored by the sec_store_set() function, the application_class parameter(s) determine which applications can retrieve the value. An application must belong to a class that is specified by theapplication_class parameter to retrieve the value. For more information, see sec_store_set(). 

Example

This example demonstrates the sec_store_get() function.

sec_store_get("ORACLE/INSTANCE1/JSMITH");