(PowerShell) Async Progress Info Log

Chilkat .NET Downloads

[Reflection.Assembly]::LoadFile("C:\myAssemblies\ChilkatDotNet47.dll")
# All Chilkat classes can be unlocked at once at the beginning of a program# by calling UnlockBundle. It requires a Bundle unlock code.
$chilkatGlob = New-ObjectChilkat.Global
$success = $chilkatGlob.UnlockBundle("Anything for 30-day trial.")
if ($success -ne $true) {
$($chilkatGlob.LastErrorText)
exit
}
# The mailman object is used for sending and receiving email.
$mailman = New-ObjectChilkat.MailMan# Set the SMTP server and any required settings.
$mailman.SmtpHost = "smtp.mymailserver.com"
$mailman.SmtpUsername = "myLogin"
$mailman.SmtpPassword = "myPassword"
$mailman.StartTLS = $true# Create a new email object
$email = New-ObjectChilkat.Email
$email.Subject = "This is a test"
$email.Body = "This is a test"
$email.From = "Chilkat Support <support@chilkatsoft.com>"
$success = $email.AddTo("Chilkat Admin","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 = $mailman.SendEmailAsync($email)
if ($task -eq $null ) {
$($mailman.LastErrorText)
exit
}
# Before starting the task, tell it to keep an in-memory log of what would've been# ProgressInfo event callbacks.
$task.KeepProgressLog = $true# Schedule the task for running on the thread pool. This changes the task's state# from Inert to Live.
$success = $task.Run()
if ($success -ne $true) {
$($task.LastErrorText)
exit
}
# 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 = 0while ($task.Finished -ne $true) {
if ($task.PercentDone -ne $curPctDone) {
$curPctDone = $task.PercentDone
$([string]$curPctDone + " percent done")
}
# Check the progress info log.# Emit any log entries..while (($task.ProgressLogSize -gt 0)) {
# Get the 1st entry, emit it, and then remove it..
$name = $task.ProgressInfoName(0)
$value = $task.ProgressInfoValue(0)
$($name + ": " + $value)
$task.RemoveProgressInfo(0)
}
# Sleep 100 ms.
$task.SleepMs(100)
}
# Just in case there are any remaining entries...while (($task.ProgressLogSize -gt 0)) {
# Get the 1st entry, emit it, and then remove it..
$name = $task.ProgressInfoName(0)
$value = $task.ProgressInfoValue(0)
$($name + ": " + $value)
$task.RemoveProgressInfo(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 ($task.StatusInt -ne 7) {
$("Task did not complete.")
$("task status: " + $task.Status)
exit
}
# 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 = $task.GetResultBool()
if ($success -ne $true) {
# The task's ResultErrorText contains what would have been in the LastErrorText property had# the SendEmail method been called synchronously.
$($task.ResultErrorText)
}
else {
$("Email sent asynchronously.")
}
$success = $mailman.CloseSmtpConnection()
if ($success -ne $true) {
$("Connection to SMTP server not closed cleanly.")
}