secWindowType
- Last UpdatedJun 06, 2017
- 2 minute read
This value is used as an argument to the ApplicationClearance and FunctionClearance methods. The value of the WinType argument determines the behavior of the security dialogs and how the user must interact with the security system.
secWindowModal (0)
This type prompts the user for information as required using a Modal security dialog. Therefore, the clearance call does not return until a result has been determined.
secWindowModeless (1)
This type prompts the user for information as required using a Modeless security dialog. Therefore, the clearance call returns immediately with a result of secResultPending, and the actual result is returned through a *ClearanceComplete event.
secWindowlessEvent (2)
This type requests information as required by firing RequestUserInfo or RequestNewPassword events. The program can then provide the required information by setting various properties on the control from within the event. It is a modal interface, which means that the clearance call does not return until a result has been determined. However, there is no built-in security dialog presented to the user. This window type is designed to allow the designer to create their own security dialog boxes, which would be invoked when the RequestUserInfo and RequestNewPassword events are raised.
secWindowlessCheck (3)
This type performs a simple one-shot access check, using information provided before the clearance method is called. It can be used when you already know the level of security required and the clearance information. The result of the clearance request is known upon return. When using this type of clearance check, you must set the DoneByUserID, DoneByPassword, CheckByUserID, and CheckByPassword properties (as needed) before you call the clearance method. You can determine which ones are required by calling the QueryApplicationSecurity or QueryFunctionSecurity methods.