NSSSAddSHSEntry

Enters a key or a value in a key-value pair stored in a Shared Secret.

Syntax

    #include <nssscl.h> 
     
    SS_EXTERN_LIBCALL(int) NSSSAddSHSEntry 
    (
     void            *handle, 
     unsigned char   *key, 
     unsigned char   *val, 
     unsigned long    ssCtxFlags
    );

Parameters

handle
(IN) Specifies the handle created by NSSSCreateSHSHandle.
key
(IN) Adds a key to a key-value pair stored in a Shared Secret.
val
(IN) Adds a value to a key-value pair stored in a Shared Secret.
ssCtxFlags
(IN) Specifies an optional structure that can be initialized by calling NSSSGetServiceInformation prior to use here. The flags field of the structure can take on the following values to indicate the type of context used.

NSSS_NCP_CTX_F—Directory Service API context indicator flag

NSSS_LDAP_CTX_F—LDAP context indicator flag <reserved>

Return Values

Value

Description

NSSS_SUCCESS

The operation succeeded.

NSSS_E_SH_SECRET_FAILURE

Shared Secret processing and operations failed.

NSSS_E_INVALID_PARAM

API parameter is not initialized.

Remarks

This function contains pointers to user-allocated key and value buffers and the unsigned long context flag member of the SSS_CONTEXT_T structure populated from calling NSSSGetServiceInformation.

See Also