discoverUserIdentities(forEmailAddresses:completionHandler:)

Declaration

@preconcurrency func discoverUserIdentities(forEmailAddresses emails: [String], completionHandler: @escaping  @Sendable (Result<[String : CKUserIdentity], any Error>) -> Void)

Parameters

• emails:

  The users’ email addresses.

• completionHandler:

  The handler to execute with the fetch results.

Discussion

This closure doesn’t return a value and takes the following parameters:

• A Result that contains either a dictionary of user identities, or an error that describes why CloudKit can’t discover the email addresses.

  In the successful case, the dictionary uses the email addresses you specify in emails as its keys. Only successfully discovered user identities are present in this dictionary.

Use this method to retrieve the identities of users who the current user knows. The users you’re searching for must meet the following criteria:

• The user has run the app.

• The user grants the userDiscoverability permission for the container.

This method searches for users asynchronously and with a low priority. If you want the task to execute the request with a higher priority, create an instance of CKDiscoverUserIdentitiesOperation and configure it to use the necessary priority.