IPortableDeviceValues::GetStringValue メソッド

GetStringValue メソッドは、キーで指定された文字列値 (型VT_LPWSTR) を取得します。

構文

HRESULT GetStringValue(
  [in]  REFPROPERTYKEY key,
  [out] LPWSTR         *pValue
);

パラメーター

key [in]

取得する項目を指定する REFPROPERTYKEY キー。

pValue [out]

取得した LPWSTR 値へのポインター。 呼び出し元は、 CoTaskMemFree を呼び出してメモリを解放する役割を担います。

戻り値

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

リターン コード 説明
S_OK
メソッドが成功しました。
DISP_E_TYPEMISMATCH
key で指定されたプロパティが LPWSTR 型ではありません。
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)
key で指定されたプロパティがコレクション内にありません。

このメソッドの使用方法の例については、「 サポートされているサービス イベントの取得」を参照してください。

必要条件

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

関連項目

IPortableDeviceValues インターフェイス

IPortableDeviceValues::GetAt

IPortableDeviceValues::SetStringValue

サポートされているサービス イベントの取得

サポートされているサービス形式の取得

サポートされているサービス メソッドの取得