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 |