Instance Method

discoverUserInfoWithEmailAddress:completionHandler:

Retrieves information about a single user based on that user’s email address.

Declaration

- (void)discoverUserInfoWithEmailAddress:(NSString *)email completionHandler:(void (^)(CKDiscoveredUserInfo *userInfo, NSError *error))completionHandler;

Parameters

email

The iCloud email address of the user you want to locate.

completionHandler

The block to execute with the results. Your block must be capable of executing on any thread of the app. This block returns no value and takes the following parameters:

userInfo

An object containing information about the user or nil if the user is not found.

error

An error object if a problem occurs or nil if the ID is retrieved successfully.

Discussion

Use this method to retrieve the ID of a user that is known to the current user. The user you are searching for must meet the following criteria:

This method searches for the user asynchronously and with a low priority. If you want the task to execute with a higher priority, create a CKDiscoverUserInfosOperation object and configure the desired priority.

See Also

Discovering User Records

- discoverAllContactUserInfosWithCompletionHandler:

Retrieves information about all discoverable users that are known to the current user.

Deprecated
- discoverAllIdentitiesWithCompletionHandler:

Fetches all user records that match an entry in the user’s address book.

- discoverUserIdentityWithEmailAddress:completionHandler:

Returns the user record ID associated in the user’s contacts with the email address.

- discoverUserIdentityWithPhoneNumber:completionHandler:

Returns the user record ID associated in the user’s contacts with the phone number.

- discoverUserIdentityWithUserRecordID:completionHandler:

Retrieves information about a single user based on the ID of the corresponding user record.

- discoverUserInfoWithUserRecordID:completionHandler:

Retrieves information about a single user based on the ID of the corresponding user record.

Deprecated
- fetchShareParticipantWithEmailAddress:completionHandler:

Retrieves information about a single share participant (a person who accepted a shared record) based on that participant’s email address.

- fetchShareParticipantWithPhoneNumber:completionHandler:

Retrieves information about a single share participant (a person who accepted a shared record) based on that participant’s phone number.

- fetchShareParticipantWithUserRecordID:completionHandler:

Retrieves information about a single share participant based on the ID of the corresponding user record.

- fetchUserRecordIDWithCompletionHandler:

Returns the user record ID associated with the current user.