Partager via


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