Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 7dce3179 authored by Steven Moreland's avatar Steven Moreland
Browse files

libbinder_ndk: clarify AParcel_writeStatusHeader 

This function only writes a status header if it is useful, but it
returns an error in this case. This is now documented here.

Bug: 111445392
Test: N/A
Change-Id: I43082ad62ccc309efe69ae486e2ce7267f1af638
parent 85eaa63b

libs/binder/ndk/include_ndk/android/binder_parcel.h

+6 −0
Original line number Diff line number Diff line
@@ -68,6 +68,12 @@ binder_status_t AParcel_readNullableStrongBinder(const AParcel* parcel, AIBinder 


/**

 * Writes an AStatus object to the next location in a non-null parcel.

 *

 * If the status is considered to be a low-level status and has no additional information other

 * than a binder_status_t (for instance, if it is created with AStatus_fromStatus), then that

 * status will be returned from this method and nothing will be written to the parcel. If either

 * this happens or if writing the status object itself fails, the return value from this function

 * should be propagated to the client, and AParcel_readStatusHeader shouldn't be called.

 */

binder_status_t AParcel_writeStatusHeader(AParcel* parcel, const AStatus* status);