Instance Method

fetchUserRecordIDWithCompletionHandler:

Returns the user record ID associated with the current user.

Declaration

- (void)fetchUserRecordIDWithCompletionHandler:(void (^)(CKRecordID *recordID, NSError *error))completionHandler;

Parameters

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:

recordID

The ID of the user record for the current user, or nil if the current device is not configured with an iCloud account.

error

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

Discussion

At startup time, fetching the user record ID may take longer while CloudKit makes the initial iCloud account request. After the initial fetch, accessing the user record ID should take less time. If no iCloud account is associated with the device, or if access to the user’s iCloud account is restricted, this method returns an error of type CKErrorNotAuthenticated.

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.

- discoverUserInfoWithEmailAddress:completionHandler:

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

Deprecated
- 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.