NAME

sec_psm_open — Open 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

error_status_t sec_psm_open(
void ∗name,
char ∗pwd,
sec_pk_domain_t ∗domain_id,
sec_psm_handle_t ∗psm_handle,
error_status_t ∗status);

Parameters

Input

nameA pointer to the name of the principal for which to open the personal security mechanism.  Supply this name in the form /.:/principal_name or /.../cell_name/principal_name/. 

pwdA pointer to the principal’s password. 

domain_idA pointer to the application domain that the principal is operating on.  (Currently, the only domain supported is sec_pk_domain_dce_pk_login.) 

Output

psm_handle
A pointer to an opaque handle to the personal security context data.

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

Description

The sec_psm_open() routine obtains a handle to a personal security mechanism for the principal specified by name by using the password specified with pwd. 

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_ok

sec_pvtkey_privileged

sec_pvtkey_no_more_memory

sec_psm_no_more_memory

Related Information

Functions: sec_psm_close(3sec).