libbinder_ndk: document association for dead binder

The AIBinder_associateClass method checks interfaceDescriptor and may
invoke an IPC. In this case, if it is called on a binder which is dead,
it will fail, which may be surprising.

Bug: 155793159
Test: N/A
Change-Id: I09b2a0c5346d254fbad46086d47e2385f55ec3a2

parent 066ff587

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

+2 −0

Original line number	Diff line number	Diff line
		@@ -408,6 +408,8 @@ int32_t AIBinder_debugGetRefCount(AIBinder* binder) __INTRODUCED_IN(29);
		* This returns true if the class association succeeds. If it fails, no change is made to the
		* binder object.
		*
		* Warning: this may fail if the binder is dead.
		*
		* Available since API level 29.
		*
		* \param binder the object to attach the class to.