libimobiledevice  1.3.0
API Documentation - Return to Homepage

◆ lockdownd_pair_with_options()

lockdownd_error_t lockdownd_pair_with_options ( lockdownd_client_t  client,
lockdownd_pair_record_t  pair_record,
plist_t  options,
plist_t *  response 
)

Pairs the device using the supplied pair record and passing the given options.

Parameters
clientThe lockdown client
pair_recordThe pair record to use for pairing. If NULL is passed, then the pair records from the current machine are used. New records will be generated automatically when pairing is done for the first time.
optionsThe pairing options to pass. Can be NULL for no options.
responseIf non-NULL a pointer to lockdownd's response dictionary is returned. The caller is responsible to free the response dictionary with plist_free().
Returns
LOCKDOWN_E_SUCCESS on success, LOCKDOWN_E_INVALID_ARG when client is NULL, LOCKDOWN_E_PLIST_ERROR if the pair_record certificates are wrong, LOCKDOWN_E_PAIRING_FAILED if the pairing failed, LOCKDOWN_E_PASSWORD_PROTECTED if the device is password protected, LOCKDOWN_E_INVALID_HOST_ID if the device does not know the caller's host id