[aaf-commits] AAF/ref-impl/include/com-api AAF.idl,1.34,1.35

[Tim B. <tbi...@us...>]

Update of /cvsroot/aaf/AAF/ref-impl/include/com-api
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv16313/ref-impl/include/com-api

Modified Files:
	AAF.idl 
Log Message:
Stubbed implementation of AAFResultToText() and AAFResultToTextBufLen().

Index: AAF.idl
===================================================================
RCS file: /cvsroot/aaf/AAF/ref-impl/include/com-api/AAF.idl,v
retrieving revision 1.34
retrieving revision 1.35
diff -C2 -d -r1.34 -r1.35
*** AAF.idl	7 Jun 2006 16:07:29 -0000	1.34
--- AAF.idl	8 Jun 2006 14:55:05 -0000	1.35
***************
*** 50120,50122 ****
--- 50120,50199 ----
  cpp_quote("")
  
+   //***********************************************************
+   //
+   // AAFResultToTextBufLen()
+   //
+   /// Returns the size of the buffer, in bytes, required for the AAFResultToText() function.
+   ///
+   /// Succeeds if all of the following are true:
+   /// - the pResultTextSize pointer is valid.
+   /// - the result is an AAFRESULT.
+   /// - the result is a recognized AAFRESULT.
+   ///
+   /// If this method fails nothing will be written to *pResultTextSize.
+   ///
+   /// This method will return the following codes:
+   /// 
+   /// AAFRESULT_SUCCESS
+   ///   - succeeded.
+   ///
+   /// AAFRESULT_NULL_PARAM
+   ///   - pResultTextSize arg is NULL.
+   ///
+   /// AAFRESULT_RESULT_NOT_AAF
+   ///   - result is not an AAFRESULT.
+   ///
+   /// AAFRESULT_RESULT_NOT_RECOGNIZED
+   ///   - result is not a recognized AAFRESULT.
+   ///
+   /// @param result [in] The result
+   /// @param pResultTextSize [out] The size of the required buffer, in bytes.
+   /// 
+ cpp_quote("STDAPI AAFResultToTextBufLen (")
+ cpp_quote("          AAFRESULT  result,")
+ cpp_quote("          aafUInt32 *   pResultTextSize);")
+ cpp_quote("")
+ 
+ 
+   //***********************************************************
+   //
+   // AAFResultToText()
+   //
+   /// /// Returns the text representation of an AAFRESULT.
+   ///
+   /// Succeeds if all of the following are true:
+   /// - the pResultText pointer is valid.
+   /// - the result is an AAFRESULT.
+   /// - the result is a recognized AAFRESULT.
+   /// - the buffer is large enough to hold the result text.
+   ///
+   /// If this method fails nothing will be written to resultText.
+   ///
+   /// This method will return the following codes:
+   /// 
+   /// AAFRESULT_SUCCESS
+   ///   - succeeded.
+   ///
+   /// AAFRESULT_NULL_PARAM
+   ///   - pResultText arg is NULL.
+   ///
+   /// AAFRESULT_RESULT_NOT_AAF
+   ///   - result is not an AAFRESULT.
+   ///
+   /// AAFRESULT_RESULT_NOT_RECOGNIZED
+   ///   - result is not a recognized AAFRESULT.
+   ///
+   /// AAFRESULT_SMALLBUF
+   ///   - pResultText is too small to hold the result text.
+   /// 
+   /// @param result [in] The result
+   /// @param pResultText [out, string, size_is(resultTextSize)] The text representation of the result
+   /// @param resultTextSize [in] The size, in bytes, of pResultText
+   /// 
+ cpp_quote("STDAPI AAFResultToText (")
+ cpp_quote("          AAFRESULT  result,")
+ cpp_quote("          aafCharacter *  pResultText,")
+ cpp_quote("          aafUInt32  resultTextSize);")
+ cpp_quote("")
+