Chilkat HOME .NET Core C# Android™ AutoIt C C# C++ Chilkat2-Python CkPython Classic ASP DataFlex Delphi ActiveX Delphi DLL Go Java Lianja Mono C# Node.js Objective-C PHP ActiveX PHP Extension Perl PowerBuilder PowerShell PureBasic Ruby SQL Server Swift 2 Swift 3,4,5... Tcl Unicode C Unicode C++ VB.NET VBScript Visual Basic 6.0 Visual FoxPro Xojo Plugin
(Unicode C) Async Progress Info LogDemonstrates checking for progress info updates when running a task asynchronously.
#include <C_CkGlobalW.h> #include <C_CkMailManW.h> #include <C_CkEmailW.h> #include <C_CkTaskW.h> void ChilkatSample(void) { HCkGlobalW chilkatGlob; BOOL success; HCkMailManW mailman; HCkEmailW email; HCkTaskW task; int curPctDone; const wchar_t *name; const wchar_t *value; // All Chilkat classes can be unlocked at once at the beginning of a program // by calling UnlockBundle. It requires a Bundle unlock code. chilkatGlob = CkGlobalW_Create(); success = CkGlobalW_UnlockBundle(chilkatGlob,L"Anything for 30-day trial."); if (success != TRUE) { wprintf(L"%s\n",CkGlobalW_lastErrorText(chilkatGlob)); CkGlobalW_Dispose(chilkatGlob); return; } // The mailman object is used for sending and receiving email. mailman = CkMailManW_Create(); // Set the SMTP server and any required settings. CkMailManW_putSmtpHost(mailman,L"smtp.mymailserver.com"); CkMailManW_putSmtpUsername(mailman,L"myLogin"); CkMailManW_putSmtpPassword(mailman,L"myPassword"); CkMailManW_putStartTLS(mailman,TRUE); // Create a new email object email = CkEmailW_Create(); CkEmailW_putSubject(email,L"This is a test"); CkEmailW_putBody(email,L"This is a test"); CkEmailW_putFrom(email,L"Chilkat Support <support@chilkatsoft.com>"); success = CkEmailW_AddTo(email,L"Chilkat Admin",L"admin@chilkatsoft.com"); // Call the async version of the SendEmail method to return a task object. // The task object is loaded, but is in the Inert state -- meaning it is // not yet scheduled to run on Chilkat's background thread pool. task = CkMailManW_SendEmailAsync(mailman,email); if (CkMailManW_getLastMethodSuccess(mailman) == FALSE) { wprintf(L"%s\n",CkMailManW_lastErrorText(mailman)); CkGlobalW_Dispose(chilkatGlob); CkMailManW_Dispose(mailman); CkEmailW_Dispose(email); return; } // Before starting the task, tell it to keep an in-memory log of what would've been // ProgressInfo event callbacks. CkTaskW_putKeepProgressLog(task,TRUE); // Schedule the task for running on the thread pool. This changes the task's state // from Inert to Live. success = CkTaskW_Run(task); if (success != TRUE) { wprintf(L"%s\n",CkTaskW_lastErrorText(task)); CkTaskW_Dispose(task); CkGlobalW_Dispose(chilkatGlob); CkMailManW_Dispose(mailman); CkEmailW_Dispose(email); return; } // The application is now free to do anything else // while the email is being sent. // For this example, we'll simply sleep and periodically // check to see if the SendEmail if finished. While checking // however, we'll report on the progress. curPctDone = 0; while (CkTaskW_getFinished(task) != TRUE) { if (CkTaskW_getPercentDone(task) != curPctDone) { curPctDone = CkTaskW_getPercentDone(task); wprintf(L"%d percent done\n",curPctDone); } // Check the progress info log. // Emit any log entries.. while ((CkTaskW_getProgressLogSize(task) > 0)) { // Get the 1st entry, emit it, and then remove it.. name = CkTaskW_progressInfoName(task,0); value = CkTaskW_progressInfoValue(task,0); wprintf(L"%s: %s\n",name,value); CkTaskW_RemoveProgressInfo(task,0); } // Sleep 100 ms. CkTaskW_SleepMs(task,100); } // Just in case there are any remaining entries... while ((CkTaskW_getProgressLogSize(task) > 0)) { // Get the 1st entry, emit it, and then remove it.. name = CkTaskW_progressInfoName(task,0); value = CkTaskW_progressInfoValue(task,0); wprintf(L"%s: %s\n",name,value); CkTaskW_RemoveProgressInfo(task,0); } // A finished task could be one that was canceled, aborted, or truly finished. // If the task was "canceled", it was canceled prior to actually starting. This could // happen if the task was canceled while waiting in a thread pool queue to be scheduled by Chilkat's // background thread pool scheduler. // If the task was "aborted", it indicates that it was canceled while running in a background thread. // The ResultErrorText will likely indicate that the task was aborted. // If the task "completed", then it ran to completion, but the actual success/failure of the method // is determined by the result obtained via a GetResult* method. (A "completed" task will // have a StatusInt equal to 7. If the task finished, but was not completed, then it must've // been aborted or canceled: if (CkTaskW_getStatusInt(task) != 7) { wprintf(L"Task did not complete.\n"); wprintf(L"task status: %s\n",CkTaskW_status(task)); CkTaskW_Dispose(task); CkGlobalW_Dispose(chilkatGlob); CkMailManW_Dispose(mailman); CkEmailW_Dispose(email); return; } // The SendEmail method returns a boolean. Therefore, after the task is finished, // we can get the boolean result by calling GetResultBool. This is the return value had // we called SendEmail synchronously. success = CkTaskW_GetResultBool(task); if (success != TRUE) { // The task's ResultErrorText contains what would have been in the LastErrorText property had // the SendEmail method been called synchronously. wprintf(L"%s\n",CkTaskW_resultErrorText(task)); } else { wprintf(L"Email sent asynchronously.\n"); } CkTaskW_Dispose(task); success = CkMailManW_CloseSmtpConnection(mailman); if (success != TRUE) { wprintf(L"Connection to SMTP server not closed cleanly.\n"); } CkGlobalW_Dispose(chilkatGlob); CkMailManW_Dispose(mailman); CkEmailW_Dispose(email); } |
© 2000-2024 Chilkat Software, Inc. All Rights Reserved.