Release 4.0.0-preview1-00201
[platform/core/csapi/tizenfx.git] / Artifacts / bin / platform / Tizen.Uix.TtsEngine.xml
1 <?xml version="1.0"?>\r
2 <doc>\r
3     <assembly>\r
4         <name>Tizen.Uix.TtsEngine</name>\r
5     </assembly>\r
6     <members>\r
7         <member name="T:Interop">\r
8             <summary>\r
9             Partial Interop Class\r
10             </summary>\r
11             <summary>\r
12             Partial Interop Class\r
13             </summary>\r
14         </member>\r
15         <member name="T:Interop.Libraries">\r
16             <summary>\r
17             Partial Libraries Class\r
18             </summary>\r
19         </member>\r
20         <member name="T:Interop.TtsEngine">\r
21             <summary>\r
22             TtsEngine Interop Class\r
23             </summary>\r
24         </member>\r
25         <!-- "F:Interop.TtsEngine.ErrorCode.OutOfMemory" 멤버에 대해 잘못된 형식의 XML 주석은 무시됩니다. -->\r
26         <!-- "F:Interop.TtsEngine.ErrorCode.IoError" 멤버에 대해 잘못된 형식의 XML 주석은 무시됩니다. -->\r
27         <!-- "F:Interop.TtsEngine.ErrorCode.InvalidParameter" 멤버에 대해 잘못된 형식의 XML 주석은 무시됩니다. -->\r
28         <!-- "F:Interop.TtsEngine.ErrorCode.NetworkDown" 멤버에 대해 잘못된 형식의 XML 주석은 무시됩니다. -->\r
29         <!-- "F:Interop.TtsEngine.ErrorCode.PermissionDenied" 멤버에 대해 잘못된 형식의 XML 주석은 무시됩니다. -->\r
30         <!-- "F:Interop.TtsEngine.ErrorCode.InvalidState" 멤버에 대해 잘못된 형식의 XML 주석은 무시됩니다. -->\r
31         <!-- "F:Interop.TtsEngine.ErrorCode.InvalidVoice" 멤버에 대해 잘못된 형식의 XML 주석은 무시됩니다. -->\r
32         <!-- "F:Interop.TtsEngine.ErrorCode.OperationFailed" 멤버에 대해 잘못된 형식의 XML 주석은 무시됩니다. -->\r
33         <!-- "F:Interop.TtsEngine.ErrorCode.NotSupportedFeature" 멤버에 대해 잘못된 형식의 XML 주석은 무시됩니다. -->\r
34         <!-- "F:Interop.TtsEngine.ErrorCode.NotSupported" 멤버에 대해 잘못된 형식의 XML 주석은 무시됩니다. -->\r
35         <member name="T:Tizen.Uix.TtsEngine.AudioType">\r
36             <summary>\r
37             Enumeration for audio type.\r
38             </summary>\r
39         </member>\r
40         <member name="F:Tizen.Uix.TtsEngine.AudioType.RawS16">\r
41             <summary>\r
42             Signed 16-bit audio type\r
43             </summary>\r
44         </member>\r
45         <member name="F:Tizen.Uix.TtsEngine.AudioType.RawU8">\r
46             <summary>\r
47             Unsigned 8-bit audio type\r
48             </summary>\r
49         </member>\r
50         <member name="F:Tizen.Uix.TtsEngine.AudioType.Max">\r
51             <summary>\r
52             Maximum Value\r
53             </summary>\r
54         </member>\r
55         <member name="T:Tizen.Uix.TtsEngine.ResultEvent">\r
56             <summary>\r
57             Enumeration for result.\r
58             </summary>\r
59         </member>\r
60         <member name="F:Tizen.Uix.TtsEngine.ResultEvent.Fail">\r
61             <summary>\r
62             Event when the voice synthesis is failed\r
63             </summary>\r
64         </member>\r
65         <member name="F:Tizen.Uix.TtsEngine.ResultEvent.Start">\r
66             <summary>\r
67             Event when the sound data is first data by callback function\r
68             </summary>\r
69         </member>\r
70         <member name="F:Tizen.Uix.TtsEngine.ResultEvent.Continue">\r
71             <summary>\r
72             Event when the next sound data exist, not first and not last\r
73             </summary>\r
74         </member>\r
75         <member name="F:Tizen.Uix.TtsEngine.ResultEvent.Finish">\r
76             <summary>\r
77             Event when the sound data is last data or sound data is only one result\r
78             </summary>\r
79         </member>\r
80         <member name="T:Tizen.Uix.TtsEngine.VoiceType">\r
81             <summary>\r
82             Enumeration for Voice Type\r
83             </summary>\r
84         </member>\r
85         <member name="F:Tizen.Uix.TtsEngine.VoiceType.Male">\r
86             <summary>\r
87             male voice type.\r
88             </summary>\r
89         </member>\r
90         <member name="F:Tizen.Uix.TtsEngine.VoiceType.Female">\r
91             <summary>\r
92             female voice type.\r
93             </summary>\r
94         </member>\r
95         <member name="F:Tizen.Uix.TtsEngine.VoiceType.Child">\r
96             <summary>\r
97             child's voice type.\r
98             </summary>\r
99         </member>\r
100         <member name="T:Tizen.Uix.TtsEngine.Error">\r
101             <summary>\r
102             Enum for Error values that can occur\r
103             </summary>\r
104         </member>\r
105         <member name="F:Tizen.Uix.TtsEngine.Error.None">\r
106             <summary>\r
107             Successful, No error\r
108             </summary>\r
109         </member>\r
110         <member name="F:Tizen.Uix.TtsEngine.Error.OutOfMemory">\r
111             <summary>\r
112             Out of Memory\r
113             </summary>\r
114         </member>\r
115         <member name="F:Tizen.Uix.TtsEngine.Error.IoError">\r
116             <summary>\r
117             I/O error\r
118             </summary>\r
119         </member>\r
120         <member name="F:Tizen.Uix.TtsEngine.Error.InvalidParameter">\r
121             <summary>\r
122             Invalid parameter\r
123             </summary>\r
124         </member>\r
125         <member name="F:Tizen.Uix.TtsEngine.Error.NetworkDown">\r
126             <summary>\r
127             Network down(Out of network)\r
128             </summary>\r
129         </member>\r
130         <member name="F:Tizen.Uix.TtsEngine.Error.InvalidState">\r
131             <summary>\r
132             Invalid state\r
133             </summary>\r
134         </member>\r
135         <member name="F:Tizen.Uix.TtsEngine.Error.InvalidVoice">\r
136             <summary>\r
137             Invalid voice\r
138             </summary>\r
139         </member>\r
140         <member name="F:Tizen.Uix.TtsEngine.Error.OperationFailed">\r
141             <summary>\r
142             Operation failed\r
143             </summary>\r
144         </member>\r
145         <member name="F:Tizen.Uix.TtsEngine.Error.NotSupportedFeature">\r
146             <summary>\r
147             Not supported feature of current engine\r
148             </summary>\r
149         </member>\r
150         <member name="F:Tizen.Uix.TtsEngine.Error.NotSupported">\r
151             <summary>\r
152             NOT supported\r
153             </summary>\r
154         </member>\r
155         <member name="F:Tizen.Uix.TtsEngine.Error.PermissionDenied">\r
156             <summary>\r
157             Permission denied\r
158             </summary>\r
159         </member>\r
160         <member name="T:Tizen.Uix.TtsEngine.Engine">\r
161             <summary>\r
162             This Class represents the Tts Engine which has to be inherited to make the engine.\r
163             </summary>\r
164         </member>\r
165         <member name="T:Tizen.Uix.TtsEngine.Engine.Action`1">\r
166             <summary>\r
167             An Action with 2 Input Parameter returning a Error\r
168             </summary>\r
169             <typeparam name="T">Generic Type for Parameter 1</typeparam>\r
170             <param name="a">The Input Parameter 1</param>\r
171             <param name="b">The Input Parameter 2</param>\r
172             <returns>Error Value</returns>\r
173         </member>\r
174         <member name="T:Tizen.Uix.TtsEngine.Engine.OutAction`1">\r
175             <summary>\r
176             An Action with 2 Out Parameter returning a Error\r
177             </summary>\r
178             <typeparam name="T">Generic Type for Parameter 1</typeparam>\r
179             <param name="a">The Input Parameter 1</param>\r
180             <param name="b">The Input Parameter 2</param>\r
181             <returns>Error Value</returns>\r
182         </member>\r
183         <member name="T:Tizen.Uix.TtsEngine.Engine.SupportedVoice">\r
184             <summary>\r
185             Called when TTS engine informs the engine service user about whole supported language and voice type list.\r
186             This callback function is implemented by the engine service user.Therefore, the engine developer does NOT have to implement this callback function. \r
187             </summary>\r
188             <remarks>\r
189             This callback function is called by ForEachSupportedVoices() to inform the whole supported voice list. userData must be transferred from ForEachSupportedVoices().\r
190             </remarks>\r
191             <param name="language">The language is specified as an ISO 3166 alpha-2 two-letter country code followed by ISO 639-1 for the two-letter language code.\r
192             For example, "ko_KR" for Korean, "en_US" for American English</param>\r
193             <param name="type">The voice type</param>\r
194             <param name="userData">The user data passed from ForEachSupportedVoices()</param>\r
195             <returns>true to continue with the next iteration of the loop false to break out of the loop</returns>\r
196             <precondition>ForEachSupportedVoices() will invoke this callback function.</precondition>\r
197         </member>\r
198         <member name="M:Tizen.Uix.TtsEngine.Engine.StartSynthesis(System.String,System.Int32,System.String,System.Int32,System.String,System.String,System.IntPtr)">\r
199             <summary>\r
200             Called when the engine service user starts to synthesize a voice, asynchronously.\r
201             </summary>\r
202             <remarks>\r
203             In this callback function, TTS engine must transfer the synthesized result to the engine service user using SendResult().\r
204             Also, if TTS engine needs the application's credential, it can set the credential granted to the application.\r
205             </remarks>\r
206             <param name="language">The language is specified as an ISO 3166 alpha-2 two-letter country code followed by ISO 639-1 for the two-letter language code.\r
207             For example, "ko_KR" for Korean, "en_US" for American English</param>\r
208             <param name="type">The voice type</param>\r
209             <param name="text">Texts</param>\r
210             <param name="speed">The speed of speaking</param>\r
211             <param name="appid">The Application ID</param>\r
212             <param name="credential">The credential granted to the application</param>\r
213             <param name="userData">The user data which must be passed to SendResult() function</param>\r
214             <returns>\r
215             Following Error Codes can be returned\r
216             1. None\r
217             2. InvalidState\r
218             3. InvalidParameter\r
219             4. InvalidVoice\r
220             5. OperationFailed\r
221             6. NetworkDown\r
222             7. PermissionDenied\r
223             </returns>\r
224             <postcondition>This function invokes SendResult()</postcondition>\r
225         </member>\r
226         <member name="M:Tizen.Uix.TtsEngine.Engine.GetInformation(System.String@,System.String@,System.String@,System.Boolean@)">\r
227             <summary>\r
228             Called when the engine service user requests the basic information of TTS engine.\r
229             </summary>\r
230             <remarks>\r
231             The allocated engineUuid, engineName, and engineSetting will be released internally.\r
232             In order to upload the engine at Tizen Appstore, both a service app and a ui app are necessary.\r
233             Therefore, engineSetting must be transferred to the engine service user.\r
234             </remarks>\r
235             <param name="engineUuid">UUID of engine</param>\r
236             <param name="engineName">Name of engine</param>\r
237             <param name="engineSetting">The engine setting application(ui app)'s app ID</param>\r
238             <param name="useNetwork">The status for using network</param>\r
239             <returns>\r
240             Following Error Codes can be returned\r
241             1. None\r
242             2. InvalidState\r
243             </returns>\r
244         </member>\r
245         <member name="M:Tizen.Uix.TtsEngine.Engine.Initialize">\r
246             <summary>\r
247             Called when the engine service user initializes TTS engine.\r
248             </summary>\r
249             <returns>\r
250             Following Error Codes can be returned\r
251             1. None\r
252             2. InvalidState\r
253             3. NotSupportedFeature\r
254             4. PermissionDenied\r
255             </returns>\r
256         </member>\r
257         <member name="M:Tizen.Uix.TtsEngine.Engine.Deinitialize">\r
258             <summary>\r
259             Called when the engine service user deinitializes TTS engine.\r
260             </summary>\r
261             <remarks>\r
262             NOTE that the engine may be terminated automatically. When this callback function is invoked, the release of resources is necessary.\r
263             </remarks>\r
264             <returns>\r
265             Following Error Codes can be returned\r
266             1. None\r
267             2. InvalidState\r
268             </returns>\r
269         </member>\r
270         <member name="M:Tizen.Uix.TtsEngine.Engine.ForEachSupportedVoices(Tizen.Uix.TtsEngine.Engine.SupportedVoice,System.IntPtr)">\r
271             <summary>\r
272             Called when the engine service user gets the whole supported voice list.\r
273             </summary>\r
274             <remarks>\r
275             In this function, the engine service user's callback function 'SupportedVoice()' is invoked repeatedly for getting all supported voices,\r
276             and userData must be transferred to 'SupportedVoice()'. If 'SupportedVoice()' returns false, it should be stopped to call 'SupportedVoice()'.</remarks>\r
277             <param name="callback">The callback function</param>\r
278             <param name="userData">The user data which must be passed to SupportedVoice()</param>\r
279             <returns>\r
280             Following Error Codes can be returned\r
281             1. None\r
282             2. OperationFailed\r
283             </returns>\r
284             <postcondition>This callback function invokes SupportedVoice() repeatedly for getting all supported voices.</postcondition>\r
285         </member>\r
286         <member name="M:Tizen.Uix.TtsEngine.Engine.IsValidVoice(System.String,System.Int32,System.Boolean@)">\r
287             <summary>\r
288             Called when the engine service user checks whether the voice is valid or not in TTS engine.\r
289             </summary>\r
290             <param name="language">The language is specified as an ISO 3166 alpha-2 two-letter country code followed by ISO 639-1 for the two-letter language code.\r
291             For example, "ko_KR" for Korean, "en_US" for American English</param>\r
292             <param name="type">The voice type</param>\r
293             <param name="isValid">A variable for checking whether the corresponding voice is valid or not. true to be valid, false to be invalid</param>\r
294             <returns>\r
295             Following Error Codes can be returned\r
296             1. None\r
297             2. InvalidParameter\r
298             </returns>\r
299         </member>\r
300         <member name="M:Tizen.Uix.TtsEngine.Engine.SetPitch(System.Int32)">\r
301             <summary>\r
302             Called when the engine service user sets the default pitch of TTS engine.\r
303             </summary>\r
304             <param name="pitch">The default pitch</param>\r
305             <returns>\r
306             Following Error Codes can be returned\r
307             1. None\r
308             2. InvalidState\r
309             3. OperationFailed\r
310             4. InvalidParameter\r
311             </returns>\r
312         </member>\r
313         <member name="M:Tizen.Uix.TtsEngine.Engine.LoadVoice(System.String,System.Int32)">\r
314             <summary>\r
315             Called when the engine service user requests to load the corresponding voice type for the first time.\r
316             </summary>\r
317             <param name="language">The language is specified as an ISO 3166 alpha-2 two-letter country code followed by ISO 639-1 for the two-letter language code.\r
318             For example, "ko_KR" for Korean, "en_US" for American English</param>\r
319             <param name="type">The voice type</param>\r
320             <returns>\r
321             Following Error Codes can be returned\r
322             1. None\r
323             2. InvalidState\r
324             3. OperationFailed\r
325             4. InvalidVoice\r
326             5. InvalidParameter\r
327             6. OutOfMemory\r
328             </returns>\r
329         </member>\r
330         <member name="M:Tizen.Uix.TtsEngine.Engine.UnloadVoice(System.String,System.Int32)">\r
331             <summary>\r
332             Called when the engine service user requests to unload the corresponding voice type or to stop using voice.\r
333             </summary>\r
334             <param name="language">The language is specified as an ISO 3166 alpha-2 two-letter country code followed by ISO 639-1 for the two-letter language code.\r
335             For example, "ko_KR" for Korean, "en_US" for American English</param>\r
336             <param name="type">The voice type</param>\r
337             <returns>\r
338             Following Error Codes can be returned\r
339             1. None\r
340             2. InvalidState\r
341             3. OperationFailed\r
342             4. InvalidVoice\r
343             5. InvalidParameter\r
344             </returns>\r
345         </member>\r
346         <member name="M:Tizen.Uix.TtsEngine.Engine.CheckAppAgreed(System.String,System.Boolean@)">\r
347             <summary>\r
348             Called when the engine service user requests for TTS engine to check whether the application agreed the usage of TTS engine.\r
349             This callback function is called when the engine service user requests for TTS engine to check the application's agreement about using the engine.\r
350             According to the need, the engine developer can provide some user interfaces to check the agreement.\r
351             </summary>\r
352             <remarks>\r
353             If the TTS engine developer wants not to check the agreement, the developer has need to return proper values as isAgreed in accordance with the intention.\r
354             true if the developer regards that every application agreed the usage of the engine, false if the developer regards that every application disagreed.\r
355             NOTE that, however, there may be any legal issue unless the developer checks the agreement.\r
356             Therefore, we suggest that the engine developers should provide a function to check the agreement.\r
357             </remarks>\r
358             <param name="appid">The Application ID</param>\r
359             <param name="isAgreed">A variable for checking whether the application agreed to use TTS engine or not. true to agree, false to disagree</param>\r
360             <returns>\r
361             Following Error Codes can be returned\r
362             1. None\r
363             2. InvalidState\r
364             3. NotSupportedFeature\r
365             4. InvalidParameter\r
366             </returns>\r
367         </member>\r
368         <member name="M:Tizen.Uix.TtsEngine.Engine.NeedAppCredential">\r
369             <summary>\r
370             Called when the engine service user checks whether TTS engine needs the application's credential.\r
371             </summary>\r
372             <returns>    true if TTS engine needs the application's credential, otherwise false </returns>\r
373         </member>\r
374         <member name="M:Tizen.Uix.TtsEngine.Engine.CancelSynthesis">\r
375             <summary>\r
376             Called when the engine service user cancels to synthesize a voice.\r
377             </summary>\r
378             <returns>\r
379             Following Error Codes can be returned\r
380             1. None\r
381             2. InvalidState\r
382             </returns>\r
383             <precondition>\r
384             StartSynthesis should be performed\r
385             </precondition>\r
386         </member>\r
387         <member name="M:Tizen.Uix.TtsEngine.Engine.#ctor">\r
388             <summary>\r
389             Public Constructor\r
390             </summary>\r
391             <feature>\r
392             http://tizen.org/feature/speech.synthesis\r
393             </feature>\r
394         </member>\r
395         <member name="M:Tizen.Uix.TtsEngine.Engine.EngineMain(System.Int32,System.String[])">\r
396             <summary>\r
397             Main function for Text-To-Speech (TTS) engine.\r
398             This function is the main function for operating TTS engine.\r
399             </summary>\r
400             <feature>\r
401             http://tizen.org/feature/speech.synthesis\r
402             </feature>\r
403             <remarks>\r
404             ServiceAppMain should be used for working the engine after this function.\r
405             </remarks>\r
406             <param name="argc">The argument count(original)</param>\r
407             <param name="argv">The argument(original)</param>\r
408             <exception cref="T:System.ArgumentException">Thrown in case of Invalid Parameter</exception>\r
409             <exception cref="T:System.NotSupportedException">Thrown in case of Not supported</exception>\r
410             <exception cref="T:System.InvalidOperationException">thrown in case of Operation failure</exception>\r
411         </member>\r
412         <member name="M:Tizen.Uix.TtsEngine.Engine.GetSpeedRange(System.Int32@,System.Int32@,System.Int32@)">\r
413             <summary>\r
414             Gets the speed range from Tizen platform\r
415             </summary>\r
416             <feature>\r
417             http://tizen.org/feature/speech.synthesis\r
418             </feature>\r
419             <remarks>\r
420             This API is used when TTS engine wants to get the speed range from Tizen platform\r
421             </remarks>\r
422             <param name="min">The minimum speed value</param>\r
423             <param name="normal">The normal speed value</param>\r
424             <param name="max">The maximum speed value</param>\r
425             <exception cref="T:System.NotSupportedException">Thrown in case of Not supported</exception>\r
426             <exception cref="T:System.InvalidOperationException">thrown in case of Operation failure</exception>\r
427         </member>\r
428         <member name="M:Tizen.Uix.TtsEngine.Engine.GetPitchRange(System.Int32@,System.Int32@,System.Int32@)">\r
429             <summary>\r
430             Gets the pitch range from Tizen platform.\r
431             </summary>\r
432             <feature>\r
433             http://tizen.org/feature/speech.synthesis\r
434             </feature>\r
435             <remarks>\r
436             This API is used when TTS engine wants to get the pitch range from Tizen platform.\r
437             </remarks>\r
438             <param name="min">The minimum pitch value</param>\r
439             <param name="normal">The normal pitch value</param>\r
440             <param name="max">The maximum pitch value</param>\r
441             <exception cref="T:System.NotSupportedException">Thrown in case of Not supported</exception>\r
442             <exception cref="T:System.InvalidOperationException">thrown in case of Operation failure</exception>\r
443         </member>\r
444         <member name="M:Tizen.Uix.TtsEngine.Engine.SendResult(Tizen.Uix.TtsEngine.ResultEvent,System.IntPtr,System.Int32,Tizen.Uix.TtsEngine.AudioType,System.Int32)">\r
445             <summary>\r
446             Sends the synthesized result to the engine service user.\r
447             </summary>\r
448             <feature>\r
449             http://tizen.org/feature/speech.synthesis\r
450             </feature>\r
451             <remarks>\r
452             This API is used in StartSynthesis(), when TTS engine sends the synthesized result to the engine service user.\r
453             The synthesized result must be transferred to the engine service user through this function.\r
454             </remarks>\r
455             <param name="resultEvent">The result event</param>\r
456             <param name="data">Result data</param>\r
457             <param name="dataSize">Result data size</param>\r
458             <param name="audioType">The audio type</param>\r
459             <param name="rate">The sample rate</param>\r
460             <exception cref="T:System.ArgumentException">Thrown in case of Invalid Parameter</exception>\r
461             <exception cref="T:System.NotSupportedException">Thrown in case of Not supported</exception>\r
462             <exception cref="T:System.InvalidOperationException">thrown in case of Operation failure</exception>\r
463             <precondition>\r
464             EngineMain function should be invoked before this function is called. StartSynthesis() will invoke this function.\r
465             </precondition>\r
466         </member>\r
467         <member name="M:Tizen.Uix.TtsEngine.Engine.SendError(Tizen.Uix.TtsEngine.Error,System.String)">\r
468             <summary>\r
469             Sends the error to the engine service user.\r
470             </summary>\r
471             <feature>\r
472             http://tizen.org/feature/speech.synthesis\r
473             </feature>\r
474             <param name="error">The error reason</param>\r
475             <param name="msg">The error message</param>\r
476             <precondition>\r
477             EngineMain function should be invoked before this function is called.\r
478             </precondition>\r
479         </member>\r
480         <member name="M:Tizen.Uix.TtsEngine.Engine.SetPrivateDataSetDelegate(Tizen.Uix.TtsEngine.Engine.Action{System.String})">\r
481             <summary>\r
482             Sets a callback function for setting the private data.\r
483             </summary>\r
484             <feature>\r
485             http://tizen.org/feature/speech.synthesis\r
486             </feature>\r
487             <param name="callback">\r
488             Called when the engine service user gets the private data from Tts engine.\r
489             In Parameters:\r
490             a = Key -- The key field of private data\r
491             b = data -- The data field of private data\r
492             Following Error Codes can be returned\r
493             1. None\r
494             2. InvalidParameter\r
495             3. OperationFailed\r
496             4. NotSupported\r
497             </param>\r
498             <exception cref="T:System.ArgumentException">Thrown in case of Invalid Parameter</exception>\r
499             <exception cref="T:System.UnauthorizedAccessException">Thrown in case of Permission denied</exception>\r
500             <exception cref="T:System.NotSupportedException">Thrown in case of Not supported</exception>\r
501             <exception cref="T:System.InvalidOperationException">thrown in case of Operation failure</exception>\r
502             <precondition>\r
503             Main function should be invoked before this function is called.\r
504             </precondition>\r
505         </member>\r
506         <member name="M:Tizen.Uix.TtsEngine.Engine.SetPrivateDataRequestedDelegate(Tizen.Uix.TtsEngine.Engine.OutAction{System.String})">\r
507             <summary>\r
508             Sets a callback function for setting the private data.\r
509             </summary>\r
510             <feature>\r
511             http://tizen.org/feature/speech.synthesis\r
512             </feature>\r
513             <param name="callback">callback function\r
514             Called when TTS engine receives the private data from the engine service user.\r
515             This callback function is called when the engine service user sends the private data to TTS engine.\r
516             Out Parameters:\r
517             a = Key -- The key field of private data\r
518             b = data -- The data field of private data\r
519             Following Error Codes can be returned\r
520             1. None\r
521             2. InvalidParameter\r
522             3. OperationFailed\r
523             4. NotSupported\r
524             </param>\r
525             <exception cref="T:System.ArgumentException">Thrown in case of Invalid Parameter</exception>\r
526             <exception cref="T:System.UnauthorizedAccessException">Thrown in case of Permission denied</exception>\r
527             <exception cref="T:System.NotSupportedException">Thrown in case of Not supported</exception>\r
528             <exception cref="T:System.InvalidOperationException">thrown in case of Operation failure</exception>\r
529             <precondition>\r
530             Main function should be invoked before this function is called.\r
531             </precondition>\r
532         </member>\r
533     </members>\r
534 </doc>\r