RPC HELP TRPCBroker ShowErrorMsgs

From VistApedia
Jump to: navigation, search

ShowErrorMsgs Property

Applies to

   TRPCBroker component

Declaration

   property ShowErrorMsgs: TShowErrorMsgs;


Description

The ShowErrorMsgs design-time property gives the developer the ability to determine how an exception will be handled, if an error handler has not been provided through the OnRpcbError property (i.e., a procedure property that is set to the name of a procedure that will be called if an error is encountered). If the OnRpcbError property is assigned, then exception processing will be delegated to that procedure. Otherwise, exception handling will be based on the value of ShowErrorMsgs property.

The following table lists the possible values:

Value -- Meaning

  • semRaise (default) -- This is the default value. The Broker will not handle the error directly but pass it off to the application in general to process, which may result in a different message box display or some other type of error indication.
  • semQuiet -- The error will not be displayed or raised. This requires the application to check the value of the RPCBError property following calls to the Broker to determine whether an error has occurred, and if so, what the error was. This may be desirable, if the application requires that errors not result in display boxes, etc., as might be the case with an NT service or Web application.

Note: Run the "Error Handling Demo" application (i.e., XWBOnFail.EXE, located in the ..\BDK\Samples\SilentSignOn p [13] directory), to illustrate the effects of TRPCBroker properties related to Error Handling.