Método IPrintSchemaParameterInitializer::p ut_Value (printerextension.h)
A propriedade Value (put_Value) modifica o valor do objeto IPrintSchemaParameterInitializer.
No PrintTicket XML, esse é o valor do elemento filho psf:Value para o elemento psf:ParameterInit.
Essa propriedade é somente gravação.
Sintaxe
HRESULT put_Value(
VARIANT *pVar
);
Parâmetros
pVar
Define o parâmetro VARIANTpVar.
Valor de retorno
Retorna um valor HRESULT. Se a chamada de propriedade não tiver sido bem-sucedida, ela retornará o código de erro HRESULT apropriado.
Observações
A propriedade Value (put_Value) passa o novo valor como 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:
| DataType de parâmetro | 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 a entrada tipo de Variant 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 |
|---|---|
| de cliente com suporte mínimo | Windows 8.1 |
| servidor com suporte mínimo | Windows Server 2012 R2 |
| da Plataforma de Destino | Windows |
| cabeçalho | printerextension.h |