src/pEpEngine.h
changeset 559 32811e6a231c
parent 554 28e92b31326d
child 561 9d8d5886494b
     1.1 --- a/src/pEpEngine.h	Thu Apr 28 22:07:10 2016 +0200
     1.2 +++ b/src/pEpEngine.h	Sat Apr 30 17:59:16 2016 +0200
     1.3 @@ -443,10 +443,32 @@
     1.4  //        more
     1.5  
     1.6  DYNAMIC_API PEP_STATUS get_identity(
     1.7 -        PEP_SESSION session, const char *address,
     1.8 +        PEP_SESSION session,
     1.9 +        const char *address,
    1.10 +        const char *user_id,
    1.11          pEp_identity **identity
    1.12      );
    1.13  
    1.14 +// get_best_user() - get best user_id candidate for a given address
    1.15 +//
    1.16 +//	parameters:
    1.17 +//		session (in)		session handle
    1.18 +//		address (in)		C string with communication address, UTF-8 encoded
    1.19 +//		user_id (out)		pointer to user_id string
    1.20 +//
    1.21 +//	caveat:
    1.22 +//	    the address string is being copied; the original string remains in the
    1.23 +//	    ownership of the caller
    1.24 +//		the resulting user_id string goes to the ownership of the
    1.25 +//		caller and has to be freed with free() when not in use any
    1.26 +//		more
    1.27 +    
    1.28 +DYNAMIC_API PEP_STATUS get_best_user(
    1.29 +        PEP_SESSION session,
    1.30 +        const char *address,
    1.31 +        char **user_id
    1.32 +    );
    1.33 +    
    1.34  
    1.35  // set_identity() - set identity information
    1.36  //