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

Weitere Informationen

IPrintSchemaParameterInitializer