Contents

fetchShareParticipant(withEmailAddress:completionHandler:)

Fetches the share participant with the specified email address.

Declaration

func fetchShareParticipant(withEmailAddress emailAddress: String, completionHandler: @escaping  @Sendable (CKShare.Participant?, (any Error)?) -> Void)
func shareParticipant(forEmailAddress emailAddress: String) async throws -> CKShare.Participant

Parameters

  • emailAddress:

    The share participant’s email address.

  • completionHandler:

    The handler to execute with the fetch results.

Discussion

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

  • The share participant, or nil if CloudKit can’t find the participant.

  • An error if a problem occurs, or nil if CloudKit successfully retrieves the participant.

CloudKit can translate any valid email address into a share participant. If the email address doesn’t correspond to a known iCloud account, then at share-accept-time, CloudKit offers the accepting participant a vetting process. The accepting participant uses this vetting process to link the email address to an iCloud account.

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

See Also

Discovering User Records