add_deletion


Description:

public uint add_deletion (Entry entry, BatchOperationCallback callback)

Add an entry to the BatchOperation, to be deleted on the server when the operation is run.

entry is reffed by the function, so may be freed after it returns.

Note that a single batch operation should not operate on a given Entry more than once, as there's no guarantee about the order in which the batch operation's operations will be performed.

callback will be called as specified in the documentation for add_query, with an operation_type of DELETION.

Parameters:

this

a BatchOperation

entry

the Entry to delete

callback

a BatchOperationCallback to call when the deletion is finished, or null

user_data

data to pass to the callback function

Returns:

operation ID for the added deletion, or 0