Metodo IPrintSchemaParameterInitializer::p ut_Value (printerextension.h)
La proprietà Value (put_Value) modifica il valore dell'oggetto IPrintSchemaParameterInitializer.
In XML PrintTicket questo è il valore dell'elemento psf:Value figlio per l'elemento psf:ParameterInit.
Questa proprietà è di sola scrittura.
Sintassi
HRESULT put_Value(
VARIANT *pVar
);
Parametri
pVar
Definisce il parametro VARIANTpVar.
Valore restituito
Restituisce un valore di HRESULT. Se la chiamata alla proprietà non è riuscita, restituisce il codice di errore HRESULT appropriato.
Osservazioni
La proprietà Value (put_Value) passa il nuovo valore come Variant. Ecco cosa prevede la funzione ricevente nel tipo Variant e dove la funzione cercherà il nuovo valore, a seconda dei diversi tipi di dati dei parametri:
| Parametro DataType | Tipo variant | Valore variante |
|---|---|---|
| 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 il tipo di input Variant non corrisponde al tipo di dati del parametro come illustrato nella tabella precedente, la chiamata alla proprietà put_Value restituirà E_INVALIDARG.
Nel caso del tipo di dati del parametro PrintSchemaParameterDataType_NumericString, la funzione convaliderà anche che la stringa V_BSTR(pVar) contenga solo caratteri numerici. Se la funzione trova caratteri non numerici, la chiamata di proprietà put_Value restituirà E_INVALIDARG.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 8.1 |
| server minimo supportato | Windows Server 2012 R2 |
| piattaforma di destinazione | Finestre |
| intestazione | printerextension.h |