sec_psm_close(3sec)

Close a personal security mechanism. This routine is not available in the DCE binary code. It is provided in DCE source for use by vendors.

Synopsis

#include <dce/sec_pk_base.h>

error_status_t sec_psm_close(

sec_psm_handle_t psm_handle,

error_status_t *status);

Parameters

Input

psm_handle
A pointer to an opaque handle to the personal security context data. Use the sec_psm_open( ) routine to obtain the handle.

Output

status
A pointer to the completion status. On successful completion, the routine returns error_status_ok. Otherwise, it returns an error.

Description

The sec_psm_close( ) routine closes the personal security mechanism identified by psm_handle. In addition, the routine cleans up the personal security context data and ensures any confidential information (such as passwords or private keys) is zeroed out.

Files

/usr/include/dce/sec_pk_base.idl
The idl file from which dce/sec_pk_base.h was derived.

Errors

The following describes a partial list of errors that might be returned. Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages.

error_status_t

sec_psm_not_init

sec_psm_invalid_handle

sec_psm_internal_error

sec_pvtkey_invalid_handle

sec_pvtkey_mechanism_not_init

Related Information

Functions:
sec_psm_open(3sec)