IPortableDeviceValues::SetStringValue メソッド

SetStringValue メソッドは、新しい文字列値 (型VT_LPWSTR) を追加するか、既存の文字列値を上書きします。

構文

HRESULT SetStringValue(
  [in] REFPROPERTYKEY key,
  [in] LPCWSTR        Value
);

key [in]: 作成または上書きする項目を指定する REFPROPERTYKEY 。
値 [in]: 新しい値を指定する LPCWSTR 。文字列がコピーされるため、呼び出し元は、このメソッドを呼び出した後、この値に割り当てられたメモリを解放できます。

このメソッドは HRESULT を返します。有効な値を次の表に示しますが、これ以外にもあります。

リターンコード	説明
S_OK	メソッドが成功しました。

既存のキーメモリは適切に解放されます。

このメソッドの使用方法の例については、「クライアント情報の指定」を参照してください。

要件	値
ヘッダー	PortableDeviceTypes.h
ライブラリ	PortableDeviceGUIDs.lib