IPrintSchemaParameterInitializer::p ut_Value メソッド (printerextension.h)

Value (put_Value) プロパティは、IPrintSchemaParameterInitializer オブジェクトの値を変更します。

PrintTicket XML では、psf:ParameterInit 要素の psf:Value 子要素の値です。

このプロパティは書き込み専用です。

構文

HRESULT put_Value(
  VARIANT *pVar
);

パラメーター

pVar

pVar VARIANT パラメーターを定義します。

戻り値

HRESULT 値を返します。 プロパティ呼び出しが成功しなかった場合は、適切な HRESULT エラー コードが返されます。

備考

Value (put_Value) プロパティは、新しい値をバリアント型 (Variant) として渡します。 バリアント型で受け取る関数が想定しているものと、さまざまなパラメーター データ型に応じて、関数が新しい値を検索する場所を次に示します。

Parameter DataType	バリアント型	バリアント型の値
PrintSchemaParameterDataType_Integer	V_VT(pVar) がVT_I4	V_I4(pVar)
PrintSchemaParameterDataType_NumericString	V_VT(pVar) がVT_BSTR	V_BSTR(pVar)
PrintSchemaParameterDataType_String	V_VT(pVar) がVT_BSTR	V_BSTR(pVar)

前の表に示すように、Variant 型 入力がパラメーター のデータ型と一致しない場合、put_Value プロパティの呼び出しは E_INVALIDARGを返します。

PrintSchemaParameterDataType_NumericString パラメーターのデータ型の場合、V_BSTR(pVar) 文字列に数値のみが含まれていることも検証されます。 関数が数値以外の文字を見つけた場合、put_Value プロパティの呼び出しは E_INVALIDARGを返します。

必要条件

要件	価値
サポートされる最小クライアント	Windows 8.1
サポートされる最小サーバー	Windows Server 2012 R2
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	printerextension.h

関連項目

IPrintSchemaParameterInitializer の