Méthode IPrintSchemaParameterInitializer ::p ut_Value (printerextension.h)

La propriété Value (put_Value) modifie la valeur de l’objet IPrintSchemaParameterInitializer .

Dans PrintTicket XML, il s’agit de la valeur de l’élément enfant psf :Value pour l’élément psf :ParameterInit .

Cette propriété est en écriture seule.

Syntaxe

HRESULT put_Value(
  VARIANT *pVar
);

Paramètres

pVar

Définit le paramètre VARIANTpVar.

Valeur retournée

Retourne une valeur HRESULT . Si l’appel de propriété n’a pas réussi, il retourne le code d’erreur HRESULT approprié.

Remarques

La propriété Value (put_Value) transmet la nouvelle valeur en tant que Variant. Voici ce que la fonction de réception attend dans le type Variant et où la fonction recherchera la nouvelle valeur, en fonction des différents types de données de paramètre :

Paramètre DataType	Type de variante	Valeur variant
PrintSchemaParameterDataType_Integer	V_VT(pVar) est VT_I4	V_I4(pVar)
PrintSchemaParameterDataType_NumericString	V_VT(pVar) est VT_BSTR	V_BSTR(pVar)
PrintSchemaParameterDataType_String	V_VT(pVar) est VT_BSTR	V_BSTR(pVar)

Si le type Variant d’entrée ne correspond pas au type de données de paramètre comme indiqué dans le tableau précédent, l’appel de propriété put_Value retourne E_INVALIDARG.

Dans le cas du type de données du paramètre PrintSchemaParameterDataType_NumericString , la fonction vérifie également que la chaîne V_BSTR(pVar) contient uniquement des caractères numériques. Si la fonction trouve des caractères non numériques, l’appel de propriété put_Value retourne E_INVALIDARG.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8.1
Serveur minimal pris en charge	Windows Server 2012 R2
Plateforme cible	Windows
En-tête	printerextension.h

Voir aussi

IPrintSchemaParameterInitializer