sec_psm_open(3sec)

Synopsis

#include <dce/sec_pk_base.h>

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

name
A 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/.

pwd
A pointer to the principal's password.

domain_id
A 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.

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