WOSA／XFS 3.10 中文版 04(5)

第21页

CWA 15748-4:2008

4.5 WFS_INF_IDC_QUERY_IFM_IDENTIFIER

描述

该命令是用于撤回全部的注册授权接口模块（IFM）识别符。主要的注册授权是EMVCo，但是也有其它的组织也支持，为的是历史的或者当地国家需要。 将来可能会增加新的注册授权，因此应用程序应该能够处理返回的新（还未定义的）的IFM识别符。 无

输入参数

输出参数 LPWFSIDCIFMIDENTIFIER *lppIFMIdentifier;

错误代码 注释

指针指向以NULL结尾的数据结构指针数组。SP支持的每一IFM识别符对应的数组元素（没有特殊的命令）。如果针对一个规定的IFM机构来说却没有IFM识别符的话，那么该局不会收到任何数组元素。如果读卡器没有IFM识别符的话，那么输出参数lppIFMIdentifier将会是NULL。 typedef struct _wfs_idc_ifm_identifier

{ WORD wIFMAuthority; LPSTR lpszIFMIdentifier;

} WFSIDCIFMIDENTIFIER, *LPWFSIDCIFMIDENTIFIER;

wIFMAuthority

指定IFM当局颁发的IFM识别符: Value

意义

WFS_IDC_IFMEMV EMVCo 编制的Level 1 型核准的 IFM 识别符 。

WFS_IDC_IFMEUROPAY Europay 编制的Level 1 型核准的 IFM 识别符 。

WFS_IDC_IFMVISA VISA 编制的Level 1 型核准的 IFM 识别符 。

WFS_IDC_IFMGIECB

GIE CartesBancaires编制的IFM识别符 。

返回一个包含由指定当局分配的芯片读卡器（或IFM）的IFM识别符的ASCII字符串。 该命令只会产生那些只有在[Ref. 1]中定义的普通的错误代码。.

如果该命令不受支持的话，并不是一定意味着该读卡器未被一个或多个专利局认可。

第22页

CWA 15748-4:2008

5. 执行命令

5.1 WFS_CMD_IDC_READ_TRACK

描述

输入参数

输出参数

错误代码

针对电动式读卡器，读卡器检查卡是否插入。如果插入的话，在lpstrFormsName 参数指定的磁道会立即读出。如果没有插入卡，包括所有其它种类的读卡器，在令中所指定的超时时间段内，等待插入或者刷卡（参见第七章，表单定义，对表单有一个WFSExecute命较为详细的描述）。当相关表单中指定了SECURE标志时，通过安全模式（也就是，MM，CIM86）的结果被确定并被加入磁道数据。

当读卡器内没卡时且读卡器准备好接收卡，会产生WFS_EXEE_IDC_INSERTCARD事件。 如果安检失败的话，或者不能执行安全检查的话，将会返回错误这无论如何都不会停止有效数据的返回。WFS_ERR_IDC_SECURITYFAIL如果表单规定安检数据只读，在其它的所有情况中，将会返回WFS_IDC_SEC_HWERRORWFS_SUCCESS，输出参数的安全字段被设定为相关的值，包括

。 针对非电动式读卡器的读卡器（它是在卡入口读取磁道数据）来说，当要求

WFS_CMD_IDC_READ_RAW_DATAWFS_ERR_INVALID_DATA错误代码。既读取磁道的数据又读取芯片的数据时，会返回 LPSTR lpstrFormName;

lpstrFormName

指向定义读取磁道数据行为的表单名（参见第七章，表单的定义）。 LPSTR lpstrTrackData;

lpstrTrackData

成功读取选定磁道的数据（以及安全模式值，如果可行的话）。 除了[Ref. 1]中定义的普通的错误外, 该命令也会出现以下错误代码： 值

意义

WFS_ERR_IDC_MEDIAJAM 卡被夹住，需要操作人员的干预。 WFS_ERR_IDC_SHUTTERFAIL 由于操作失误或者硬件故障，而未能成功打开或关闭卡口，需要操作人员的干预。

WFS_ERR_IDC_INVALIDDATA

由于无效磁道数据而造成，读取规定表单定义的数据失败。这将会被返回，如果所有处于?or? (|) 操作的磁道不能被读取或者任一个处于?and? (&)操作中的磁道不能被读取的话。lpstrTrackData 指向成功读取数据的磁道（如果有的话）。针对每一个不能成功读取数据的轨道来说，都会产生一个WFS_EXEE_IDC_INVALIDTRACKDAT执行事件。参考表单描述中，针对轨道如何规范的规则。 第23页

CWA 15748-4:2008

事件

在完成读取操作之前，卡被移除（产生了WFS_EXEE_IDC_MEDIAINSERTED事件）。针对电动式读卡器来说，读取操作是失效的；也就是说必须发出另外一个命令使得读卡器读取数据。

WFS_ERR_IDC_INVALIDMEDIA 没有发现磁道，插卡或刷卡的方式错误。 WFS_ERR_IDC_FORMNOTFOUND 未能找到指定的表单。 WFS_ERR_IDC_FORMINVALID 指定的表单定义无效 (例如：句法错误) WFS_ERR_IDC_SECURITYFAIL 安全模式没有成功读取卡的安全标识。 WFS_ERR_IDC_CARDTOOSHORT 插入的卡太短。当出现这种错误时，卡依

旧在卡口位置.

WFS_ERR_IDC_CARDTOOLONG 插入的卡太长。当出现这种错误时，卡依

旧在卡口位置。

除了[Ref. 1]中定义的普通的事件外, 该命令也会出现以下事件：

值 意义

WFS_EXEE_IDC_INVALIDTRACKDATA 针对一个空白磁道（没有数据）或者无

效的磁道（磁道数据读取错误或者数据与规定的表单定义不一致）来说都会产生一个事件。

WFS_EXEE_IDC_MEDIAINSERTED 当发现读卡器内有卡时，会产生该事件，提前警告应用程序一个卡的进入，允许它移除一个用户提示符和/或读卡时操作其它的程序。

WFS_SRVE_IDC_MEDIAREMOVED 当读取数据操作完成之前，就移除

了卡，会产生该事件。

WFS_EXEE_IDC_INVALIDMEDIA 用户试图以错误的方向插入卡。读卡器没

有接受该卡。读卡器依旧时刻准备着接受以正确方式插入的卡。

WFS_EXEE_IDC_INSERTCARD 读卡器准备接受来自用户的卡。

WFS_ERR_IDC_NOMEDIA

注释

磁道的关键词可能领先于磁道数据，用?:?隔开。字段数据总是被与之对应的关键词超过，用?=?隔开。用0x00隔开字段。用额外的0x00将不同的磁道隔开。数据的结尾被另外一个0x00隔开（参见下列）。在第七章，表单定义中，定义了数据编码。 lpstrTrackData:例子 TRACK2:ALL=47..\\0\\0TRACK3:MII=59\\0PAN=500..\\0\\0\\0

第24页

CWA 15748-4:2008

5.2 WFS_CMD_IDC_WRITE_TRACK

描述

输入参数

输出参数 错误代码

针对电动式读卡器的读卡器来说，读卡器会检查是否插入了卡。如果是的话，那么数据将会写入由表单里lpstrFormName 参数和其他参数所描述的磁道里。 如果没有插入卡，包括所有其它种类的读卡器，在WFSExecute命令中所指定的超时时间段内，等待插入或者刷卡。然后将表单参数中指定的磁道数据写入相应的磁道（参见第七章，表单定义，对表单有一个较为详细的描述）。 处理之后是数据确认。

当读卡器内没卡时且读卡器准备好接收卡，会产生WFS_EXEE_IDC_INSERTCARD事件。 如果在写卡的过程中停电了，那么操作结果将会是依据厂商的不同而不同，并不能确定写入操作的成功。

LPWFSIDCWRITETRACK lpWriteTrack;

typedef struct _wfs_idc_write_track

{

LPSTR lpstrFormName; LPSTR lpstrTrackData; WORD fwWriteMethod;

} WFSIDCWRITETRACK, *LPWFSIDCWRITETRACK;

lpstrFormName

指向要使用的表单名。 lpstrTrackData

指向表单中要使用的数据。 fwWriteMethod

指明要写的磁道是高磁还是低磁： Value

意义

WFS_IDC_LOCO 写低磁磁道。 WFS_IDC_HICO 写高磁磁道。

WFS_IDC_AUTO

SP决定是写低磁磁道还是高磁磁道

无 除了[Ref. 1]中定义的普通的错误外, 该命令也会出现以下错误代码： Value

意义 WFS_ERR_IDC_MEDIAJAM 卡被夹住，需要操作人员的干预。 WFS_ERR_IDC_SHUTTERFAIL 由于操作失误或者硬件故障，而未能成功打开或关闭卡口，需要操作人员的干预。

WFS_ERR_IDC_NOMEDIA

在完成读取操作之前，卡被移除（产生了WFS_EXEE_IDC_MEDIAINSERTED事件）。针对电动式读卡器来说，读取操作是失效的；也就是说必须发出另外一个命令使得读卡器读取数据。 WFS_ERR_IDC_INVALIDDATA 当写入磁道卡时出现了错误。 WFS_ERR_IDC_DATASYNTAX

lpstrTrackData者与表单定义不一致。 指定的数据语法错误或

第25页

CWA 15748-4:2008

事件

WFS_ERR_IDC_INVALIDMEDIA 没有发现磁道，插卡或刷卡的方式错误。 WFS_ERR_IDC_FORMNOTFOUND 未能找到指定的表单。 WFS_ERR_IDC_FORMINVALID 指定的表单定义无效 (例如：句法错误) WFS_ERR_IDC_WRITE_METHOD fwWriteMethod 值读卡器不支持 WFS_ERR_IDC_CARDTOOSHORT 插入的卡太短。当出现这种错误时，卡

依旧在卡口位置。

WFS_ERR_IDC_CARDTOOLONG 插入的卡太长。当出现这种错误时，卡依

旧在卡口位置。 除了[Ref. 1]中定义的普通的事件外, 该命令也会出现以下事件：

Value 意义

WFS_EXEE_IDC_INVALIDTRACKDATA 针对一个空白磁道（没有数据）或者无

效的磁道（磁道数据读取错误或者数据与规定的表单定义不一致）来说都会产生一个

WFS_EXEE_IDC_MEDIAINSERTED事件。

当发现读卡器内有卡时，会产生该事件，提前警告应用程序一个卡的进入，允许它移除一个用户提示符和/或读卡时操作其它的程序。

WFS_SRVE_IDC_MEDIAREMOVED 当读取数据操作完成之前，就移除了卡，会

产生该事件。

WFS_EXEE_IDC_INVALIDMEDIA 用户试图以错误的方向插入卡。读卡器没

有接受该卡。读卡器依旧时刻准备着接受以正确方式插入的卡。

WFS_EXEE_IDC_INSERTCARD 读卡器准备接受来自用户的卡。

注释

字段数据相对应的关键词总是领先于字段数据，用?=?隔开。关键词可能是表单中定义的字段关键词之一或者预先设定的关键词?ALL?。用0x00隔开字段。用额外的0x00将不同的磁道隔开。缓冲器的结尾被另外一个0x00隔开（参见下列）。该规范意味着，在同一个命令中只能写入一个磁道。但是如果一个读卡器没有写入功能的话，那么将会返回WFS_ERR_UNSUPP_COMMAND 错误。 lpstrTrackData的: RETRYCOUNT=3\\0DATE=3132\\0\\0

百度搜索“77cn”或“免费范文网”即可找到本站免费阅读全部范文。收藏本站方便下次阅读，免费范文网，提供经典小说综合文库WOSA／XFS 3.10 中文版 04(5)在线全文阅读。