IPrintSchemaParameterInitializer ::p ut_Value, méthode (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 VARIANT pVar.
Valeur de retour
Retourne une valeur HRESULT. Si l’appel de propriété n’a pas réussi, il retourne l'HRESULT code d’erreur 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 recherche 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 l’entrée type de variant 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 valide é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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 8.1 |
| serveur minimum pris en charge | Windows Server 2012 R2 |
| plateforme cible | Windows |
| d’en-tête | printerextension.h |