PSPropertyBag_ReadStr関数 (propsys.h)
プロパティ バッグ内のプロパティの文字列データ値を読み取ります。
構文
PSSTDAPI PSPropertyBag_ReadStr(
[in] IPropertyBag *propBag,
[in] LPCWSTR propName,
[out] LPWSTR value,
[out] int characterCount
);
パラメーター
[in] propBag
種類: IPropertyBag*
プロパティが格納されているプロパティ バッグを表す IPropertyBag オブジェクトへのポインター。
[in] propName
種類: LPCWSTR
null で終わるプロパティ名の文字列。
[out] value
種類: LPCWSTR
この関数が戻るとき、 には文字列プロパティ値へのポインターが含まれます。
[out] characterCount
型: int
この関数は、返される 値 パラメーターのサイズ (最大文字数) を表す整数を返します。
戻り値
種類: HRESULT
この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。
注釈
プロパティ バッグプロパティ関数 API は、ウィンドウ型と、プロパティ バッグ内の値を表すために使用される VARIANT 型の間で変換します。 これにより、プロパティ バッグの使用が容易になり、アプリケーションが簡素化され、一般的なコーディング エラーが回避されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | propsys.h |
| Library | Propsys.lib |
| [DLL] | Propsys.dll (バージョン 6.0 以降) |