Enrich documentation to tr_sess_get_nonce_tpm

Author: Muxi Yan

tss-esapi/src/context/session_administration.rs

@@ -54,6 +54,29 @@ impl Context {
     }
 
     /// Get the TPM nonce from a session.
+    ///
+    /// # Arguments
+    /// * `session` - An [AuthSession] handle to the authentication session from
+    /// which to retrieve the TPM nonce.
+    ///
+    /// # Returns
+    /// The TPM nonce as a [Nonce] struct on success.
+    ///
+    /// # Details
+    /// This function retrieves the nonceTPM value from an authentication session.
+    ///
+    /// Extracted nonceTPM can be useful in some scenarios. For example, a TPM object protected by a
+    /// PolicySigned policy requires the nonceTPM value to be extracted and included in the signed
+    /// digest to satisfy the policy.
+    ///
+    /// # Example
+    /// ```rust
+    /// # use tss_esapi::{Context, AuthSession};
+    /// let mut context = Context::new()?;
+    /// let session = context.start_auth_session(None, None, None, SessionType::Policy, SymmetricDefinition::AES_256_CFB, HashingAlgorithm::Sha256)?;
+    /// let nonce_tpm = context.tr_sess_get_nonce_tpm(session)?;
+    /// // Use the nonce_tpm value as needed
+    /// ```
     pub fn tr_sess_get_nonce_tpm(&mut self, session: AuthSession) -> Result<Nonce> {
         let mut nonce_ptr = std::ptr::null_mut();
         ReturnCode::ensure_success(