Table of Contents

Table of Contents

1. Introduction

1.1 Background

1.2 Strategies

2. WOSA Extensions for Financial Services Overview

2.1 Architecture

2.2 API and SPI Summary

2.3 Device Classes

3. Architectural and Implementation Issues

3.1 The XFS Manager

3.2 Service Providers

3.2.1 Service Provider Functionality

3.2.2 Service Provider “Packaging”

3.3 Asynchronous, Synchronous and Immediate Functions

3.3.1 Asynchronous Functions

3.3.2 Synchronous Functions

3.3.3 Immediate Functions

3.4 Processing API Functions

3.5 Opening a session

3.6 Closing a Session

3.7 Configuration Information

3.8 Exclusive Service and Device Access: 3.8.1 Lock Policy for Independent Devices
3.8.2 Compound Devices

3.9 Timeout

3.10 Function Status Return

3.11 Notification Mechanisms — Registering for Events

3.12 Application Processes, Threads and Blocking Functions

3.13 Memory Management

4. Application Programming Interface (API) Functions

4.1 WFSCancelAsyncRequest

4.2 WFSCancelBlockingCall

4.3 WFSCleanUp

4.4 WFSClose

4.5 WFSAsyncClose

4.6 WFSCreateAppHandle

4.7 WFSDeregister

4.8 WFSAsyncDeregister

4.9 WFSDestroyAppHandle

4.10 WFSExecute

4.11 WFSAsyncExecute

4.12 WFSFreeResult

4.13 WFSGetInfo

4.14 WFSAsyncGetInfo

4.15 WFSIsBlocking

4.16 WFSLock

4.17 WFSAsyncLock

4.18 WFSOpen

4.19 WFSAsyncOpen

4.20 WFSRegister

4.21 WFSAsyncRegister

4.22 WFSSetBlockingHook

4.23 WFSStartUp

4.24 WFSUnhookBlockingHook

4.25 WFSUnlock

4.26 WFSAsyncUnlock

5. Service Provider Interface (SPI) Functions

5.1 WFPCancelAsyncRequest

5.2 WFPClose

5.3 WFPDeregister

5.4 WFPExecute

5.5 WFPGetInfo

5.6 WFPLock

5.7 WFPOpen

5.8 WFPRegister

5.9 WFPSetTraceLevel

5.10 WFPUnloadService

5.11 WFPUnlock

6. Support Functions

6.1 WFMAllocateBuffer

6.2 WFMAllocateMore

6.3 WFMFreeBuffer

6.4 WFMGetTraceLevel

6.5 WFMKillTimer

6.6 WFMOutputTraceData

6.7 WFMReleaseDLL

6.8 WFMSetTimer

6.9 WFMSetTraceLevel

7. Configuration Functions

7.1 WFMCloseKey

7.2 WFMCreateKey

7.3 WFMDeleteKey

7.4 WFMDeleteValue

7.5 WFMEnumKey

7.6 WFMEnumValue

7.7 WFMOpenKey

7.8 WFMQueryValue

7.9 WFMSetValue

8. Data Structures

8.1 WFSRESULT

8.2 WFSVERSION

9. Messages

9.1 Command Completions and Events

9.1.1 Command Completion Messages

9.1.2 Event Messages

9.2 Timer Events

9.3 Device Status Changes

9.4 Undeliverable Messages

9.5 Application Disconnect

9.6 Hardware and Software Errors

9.7 Version Negotiation Failures

10. Error Codes

11. Appendix A - Planned Enhancements and Extensions: 11.1 Event and System Management

12. Appendix B - Banking Solutions Vendor Council Contacts

13. Appendix C - Other WOSA Specifications and Information

14. Appendix D - C-Header files

14.1 XFSAPI.H

14.2 XFSADMIN.H

14.3 XFSCONF.H

14.4 XFSSPI.H