Syntax

    typedef	 struct SSS_CONTEXT_T
    {
        unsigned long   		flags; 
        unsigned long   dsCtx; 
        unsigned long   version; 
        SS_SERVER_INFO_TssServerInfo; 
        SS_OBJECT_DN_T  callerDN; 
        SSS_HANDLES_T  *handles; 
        void           *bindInfo;
    } SSS_CONTEXT_T;
    

Fields

flags (IN)

Specifies what type of context was passed in:

Flag	Description	Action
NSSS_NCP_CTX_F	NCP context type (dsCtx)
NSSS_LDAP_CTX_F	LDAP context type (dsCtx)
NSSS_CONTEXT_INITIALIZED_F	The context already is initialized.	Context could be initialized outside the SecretStore client or inside through a previous call to NSSSGetServiceInformation
NSSS_INIT_LDAP_SS_HANDLE_F	Initializes the handle's structure without a bind.	In the case of context having been initialized outside SecretStore the caller must pass this flag to allocate and initialize the internal handles structure with necessary state data
NSSS_DEINIT_LDAP_SS_HANDLE_F	Deinitializes the handle's structure without unbind.	In the case of context having been initialized outside SecretStore the caller must pass this flag to free the internal handles structure after the state data is no longer needed
NSSS_NSSS_REINIT_TARGET_DN_F	Reinitializes the target DN saved in the context.	In the case of client switching between different eDirectory trees this flag should be used to update the copy of Target DN saved in the context
NSSS_LDAP_CONTEXT_LESS_DN_F	Resolves LDAP DN as contextless.	Indicates that a contextless DN is passed on the request for bind and prompts the SecretStore to search the tree to find the full DN of the user. In case of multiple DNs containing the common
NSSS_ADV_BIND_INFO_T	Use advanced bind structure and run service location.	Indicates that the advanced bind structure is passed in and SecretStore is prompted to perform a service location to find the proper target server for the user in the eDirectory tree.

dsCtx

Specifies the Directory Service NCP/LDAP context.

version

Points to the LDAP Context (reserved for future).

epPword (optional IN)

Encodes the actual clear password supplied.

Description

This is an optional parameter that allows the SecretStore client to keep a stateful session with the SecretStore server based on the session-related information stored in this context.