Compartilhar via


Método IPrintSchemaParameterInitializer::p ut_Value (printerextension.h)

A propriedade Value (put_Value) modifica o valor do objeto IPrintSchemaParameterInitializer .

Em PrintTicket XML, esse é o valor do elemento filho psf:Value para o elemento psf:ParameterInit .

Essa propriedade é somente gravação.

Syntax

HRESULT put_Value(
  VARIANT *pVar
);

Parâmetros

pVar

Define o parâmetro VARIANTpVar.

Retornar valor

Retorna um valor HRESULT . Se a chamada de propriedade não tiver sido bem-sucedida, ela retornará o código de erro HRESULT apropriado.

Comentários

A propriedade Value (put_Value) passa o novo valor como um Variant. Aqui está o que a função de recebimento espera no tipo Variant e onde a função procurará o novo valor, dependendo dos diferentes tipos de dados de parâmetro:

Parâmetro DataType Tipo de variante Valor variant
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)

Se o tipo Variant de entrada não corresponder ao tipo de dados de parâmetro, conforme mostrado na tabela anterior, a chamada de propriedade put_Value retornará E_INVALIDARG.

No caso do tipo de dados de parâmetro PrintSchemaParameterDataType_NumericString , a função também validará que a cadeia de caracteres V_BSTR(pVar) contém apenas caracteres numéricos. Se a função encontrar caracteres não numéricos, a chamada de propriedade put_Value retornará E_INVALIDARG.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8.1
Servidor mínimo com suporte Windows Server 2012 R2
Plataforma de Destino Windows
Cabeçalho printerextension.h

Confira também

IPrintSchemaParameterInitializer