InvalidateCache Method

InvalidateCache Method

Issues an asynchronous request to Speech Engine Services (SES) or Telephony Application Services (TAS), requesting invalidation of cache entries.

For SES, this request causes the service to reload the application manifest file and all associated resources. For TAS, this request causes the service to reload the Start page for any idle SALT interpreters, and to recompile and recache any cached application prompt files or scripts.

ret = obj.InvalidateCache

Parts

Part

Description

ret

An integer variable to catch the method's return value.

obj

An instance of either the SES or TAS class.

Return Values

The method returns one of the values in the following table, or any other value to indicate an error.

Value

Meaning

0

Success

2

Access denied

8

Unknown Failure

Remarks

Information on the status of the InvalidateCache request is returned immediately. However, the service requires time to process control commands. The return code from the method indicates that the request was only accepted by the service, not that the request was successfully carried out.

Because this service control method is asynchronous, the client must take steps to obtain the results of the call. There are two possible methods to obtain results:

  • Subscribe to an event that provides a notification when the service reaches the required state.

  • Poll the instance and check the status property until it is correct or a time-out occurs.

Windows Management Instrumentation (WMI) Script Example

strHostname = "localhost"

' Create an instance of the SES class.
Set objSpeechServer = GetObject("winmgmts:\\" & strHostname & "\root\MSS:SES=@")

' Call the method.
intValue = objSpeechServer.InvalidateCache

' Display the return value.
WScript.Echo intValue

Member Of

SES class
TAS class