GetSignatureAndWriteValue 方法

通过事先调用 Initialize()InitalizeList()IsSignatureRequired()IsSignatureRequiredForList(),基于 ESignature 对象中属性集的值显示“电子签名”对话框。通常,您在执行 FIX32 数据源的电子签名时使用此方法。对话框验证签名,向数据库发送写入请求,然后向报警系统发送一条签名操作员消息。

如果不需校验,仅显示“电子签名”对话框的“执行人”部分。如果需要校验,显示“执行人”以及“校验人”部分。如果配置标签以允许连续使用,“执行人”用户名称对话框中出现连续用户名称。根据传入的阈值表名称显示预定义注释。如果没有传入任何阈值表名称,使用在工作台用户首选项中设置的阈值表名称(如有),在对话框中显示注释选择表。

语法

object.GetSignatureAndWriteValue(nAction, pValue, [bReadLabels], [bstrZeroLabel], [bstrNonZeroLabel], [bstrDescription], [bstrPerformCommentTbl], [bstrVerifyCommentTbl], [pbValidSig], [bstrDialogCaption])

属性

GetSignatureAndWriteValue 方法语法有这些部分:

组成部分

描述

对象

对象表达式,其值为“应用到”列表中的一个对象。

nAction

整数。指示需要执行的操作类型。Valid entries for nAction include:
0 – (WRITE_VAL). 在验证签名之后,pValue中传送的值被写入数据库,并向报警系统发送一条已签名操作员消息,以记录操作。
1 – (ACK). 确认单个报警。在验证签名之后,确认报警,并向报警系统发送一条已签名操作员消息,以记录操作。
3 – (ACK_OR_REMOVE). 确认单个报警。在验证签名之后,确认列表中的报警,并为每一条得到成功确认的报警向报警系统发送一条已签名操作员消息。对于需要执行并校验签名的列表,如果执行签名未能通过针对列表中任何报警的安全区域检查,则签名不能用于整个报警列表,且不确认任何报警。产生一个错误。

pValue

变量。变量 包含要写入数据库的值。

bReadLabels

布尔值。(可选)。指示是否应从数据库读取零和非零描述标签。这些标签对在“电子签名”对话框中显示的消息串进行格式化,并描述签名针对的操作。默认为True

bstrZeroLabel

字符串。(可选)。格式化消息串时所用的零描述标签。消息串显示在“电子签名”对话框中,并描述了被签名的操作。

bstrNonZeroLabel

字符串。(可选)。消息串的非零描述标签。消息串显示在“电子签名”对话框中,并描述了签名的操作。

bstrDescription

字符串。(可选)。在“电子签名”对话框中显示并描述签名针对操作的消息串。这被附加到由对象根据nAction参数而创建的所有描述中。

bstrPerformCommentTbl

字符串。(可选)。用于显示默认注释的“执行者”注释阈值表的名称。

bstrVerifyCommentTbl

字符串。(可选)。用于显示默认注释的“校验者”注释阈值表的名称。

pbValidSig

布尔值。(可选)。如果捕获有效签名,返回True,否则返回False

bstrDialogCaption

字符串。(可选)。包含将在电子签名对话框标题栏中显示的标题,用于代替默认的标题“电子签名”。

返回值

此方法返回 HRESULT。如果 HRESULT 的值不是 S_OK,VBA 将生成错误。可以使用 On Error 语句来处理此错误。可以使用 Err 对象来找出有关错误的更多信息。

 

示例

应用到

您最近了解过 iFIX 吗 ?

查看最新版 iFIX 的所有新功能。

让 iFIX 帮助您提高效率,降低成本。