sec_store_get()

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

Syntax

sec_store_get(key)

Parameter

Parameter

Definition

key

text that identifies which value is returned by the secure area of the PATROL Agent

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()

errno Value

Description of Failure

139

E_PSL_SKS_BAD_ACCOUNT 
The user account that executed this function does not have permission to access the SKS archive.

140

E_PSL_SKS_INSTANCE_ERR 
PATROL could not find the application instance that executed this function.

141

E_PSL_SKS_SET_ERR 
PATROL could not set this value in the SKS archive.

142

E_PSL_SKS_GET_ERR 
PATROL could not get this value from the SKS archive.

Example

This example demonstrates the sec_store_get() function.

sec_store_get("ORACLE/INSTANCE1/JSMITH");


Was this page helpful? Yes No Submitting... Thank you

Comments