PIN Enter DLL Help

An application may specify the number of digits in the PIN from 4 to 9 (10 digits could exceed 32 bits). Only the correct number of digit boxes will be on the PIN popup. Or, the application could allow the user an optional number of digits, from 4 to 9. In this case there will 9 digits boxes, on the popup window. The user leaves any extra boxes at the right blank.

The application can require dual PIN entry in some cases. Then the PIN popup will have 2 rows of PIN digit boxes. Enter the same PIN in both rows. An example would be creating a new PIN. Dual entry helps user avoid a "typo", and not knowing the "real" PIN that was created.

Task Buttons/Icons

Icon Buttons On The Enter PIN Popup

View Pin. Unhides the PIN digits (replace mask characters with the actual number characters.

Hide PIN. Replace PIN digits with masking characters.

Submit PIN. The PIN has been entered. Press/click this to continue with open box, new box or delete box.

PIN Help. Opens this page in default browser.

Cancel PIN. Close the popup and no return.

Other Icons

Supplied for use as buttons in the calling application.

48 pixel

32 pixel

24 pixel

16 pixel, is also on caption bar of the popup.

Declarations For The Calling Code

Implicit is at startup(load failure is fatal to application):

DECLARE FUNCTION PIN_Enter LIB "EnterPIN.dll" ALIAS "PIN_Enter" _
                                            (BYVAL hParent AS DWORD, _
                                             BYVAL DuplPIN AS LONG, _
                                             BYVAL NumOfDigits AS LONG) AS DWORD

Explicit is during run (PowerBASIC IMPORT or Windows API LoadLibrary):

The declare for USING in CALL DWORD

DECLARE FUNCTION PIN_Enter (BYVAL hParent AS DWORD, _
                            BYVAL DuplPIN AS LONG, _
                            BYVAL NumOfDigits AS LONG) AS DWORD

PB's Import

IMPORT PIN_Enter, "EnterPIN.dll" TO function_pointer, lib_handle

Windows API

Load the DLL

DECLARE FUNCTION LoadLibrary LIB "Kernel32.dll" ALIAS "LoadLibraryW" _
    (lpLibFileName AS WSTRINGZ) AS DWORD

Get the pointer

DECLARE FUNCTION GetProcAddress LIB "Kernel32.dll" ALIAS "GetProcAddress" _
    (BYVAL hModule AS DWORD, lpProcName AS ASCIIZ) AS LONG

Call The Function

CALL DWORD function_pointer USING PIN_Enter (hParent, DuplPIN, NumOfDigits TO Result