IPrintSchemaParameterInitializer::p ut_Value 方法(printerextension.h)

Value (put_Value) 属性修改 IPrintSchemaParameterInitializer 对象的值。

在 PrintTicket XML 中,它是 psf:ParameterInit 元素的 psf:Value 子元素的值。

此属性是仅写的。

语法

HRESULT put_Value(
  VARIANT *pVar
);

参数

pVar

pVar定义 VARIANT 参数。

返回值

返回 HRESULT 值。 如果属性调用未成功,它将返回相应的 HRESULT 错误代码。

言论

Value (put_Value) 属性将新值作为 Variant 传递。 下面是接收函数在 Variant 类型中需要的内容,以及该函数将查找新值的位置,具体取决于不同的参数数据类型:

Parameter DataType 变体类型 变量值
PrintSchemaParameterDataType_Integer V_VT(pVar)是VT_I4 V_I4(pVar)
PrintSchemaParameterDataType_NumericString V_VT(pVar)是VT_BSTR V_BSTR(pVar)
PrintSchemaParameterDataType_String V_VT(pVar)是VT_BSTR V_BSTR(pVar)

如果输入 Variant 类型与参数数据类型不匹配,如上表所示,则put_Value属性调用将返回 E_INVALIDARG

对于 PrintSchemaParameterDataType_NumericString 参数数据类型,该函数还将验证 V_BSTR(pVar) 字符串是否仅包含数字字符。 如果函数找到任何非数值字符,则put_Value属性调用将返回 E_INVALIDARG

要求

要求 价值
最低支持的客户端 Windows 8.1
支持的最低服务器 Windows Server 2012 R2
目标平台 窗户
标头 printerextension.h

另请参阅

IPrintSchemaParameterInitializer