Update documentation for psa_destroy_key
Define the affect on handles to the key and on active multipart
operations.
diff --git a/include/psa/crypto.h b/include/psa/crypto.h
index 8aa11ce..eac0ff2 100644
--- a/include/psa/crypto.h
+++ b/include/psa/crypto.h
@@ -506,6 +506,11 @@
* This function also erases any metadata such as policies and frees all
* resources associated with the key.
*
+ * Destroying a key will invalidate all existing handles to the key.
+ *
+ * If the key is currently in use in a multipart operation, then destroying the
+ * key will abort the multipart operation.
+ *
* \param handle Handle to the key to erase.
*
* \retval #PSA_SUCCESS