IPrintSchemaParameterInitializer::p ut_Value-Methode (printerextension.h)
Die Value-Eigenschaft (put_Value) ändert den Wert des IPrintSchemaParameterInitializer-Objekts .
In PrintTicket XML ist dies der Wert des untergeordneten psf:Value-Elements für das psf:ParameterInit-Element .
Diese Eigenschaft ist lesegeschützt.
Syntax
HRESULT put_Value(
VARIANT *pVar
);
Parameter
pVar
Definiert den VARIANT-ParameterpVar.
Rückgabewert
Gibt einen HRESULT-Wert zurück. Wenn der Eigenschaftenaufruf nicht erfolgreich war, wird der entsprechende HRESULT-Fehlercode zurückgegeben.
Hinweise
Die Value -Eigenschaft (put_Value) übergibt den neuen Wert als Variant. Hier sehen Sie, was die empfangende Funktion im Variant-Typ erwartet, und wo die Funktion abhängig von den verschiedenen Parameterdatentypen nach dem neuen Wert sucht:
| Parameterdatentyp | Varianttyp | Variant-Wert |
|---|---|---|
| PrintSchemaParameterDataType_Integer | V_VT(pVar) ist VT_I4 | V_I4(pVar) |
| PrintSchemaParameterDataType_NumericString | V_VT(pVar) ist VT_BSTR | V_BSTR(pVar) |
| PrintSchemaParameterDataType_String | V_VT(pVar) ist VT_BSTR | V_BSTR(pVar) |
Wenn der Eingabetyp Variant nicht mit dem Parameterdatentyp übereinstimmt, wie in der vorherigen Tabelle gezeigt, gibt der put_Value-Eigenschaftsaufruf E_INVALIDARG zurück.
Im Fall des PrintSchemaParameterDataType_NumericString-Parameterdatentyps überprüft die Funktion auch, dass die V_BSTR(pVar)-Zeichenfolge nur numerische Zeichen enthält. Wenn die Funktion nicht numerische Zeichen findet, gibt der put_Value-Eigenschaftsaufruf E_INVALIDARG zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8.1 |
| Unterstützte Mindestversion (Server) | Windows Server 2012 R2 |
| Zielplattform | Windows |
| Kopfzeile | printerextension.h |