InitVariantFromStrRet 関数 (propvarutil.h)
STRRET 構造体に格納されている文字列を使用して VARIANT 構造体を初期化します。
構文
PSSTDAPI InitVariantFromStrRet(
[in] STRRET *pstrret,
[in] PCUITEMID_CHILD pidl,
[out] VARIANT *pvar
);
パラメーター
[in] pstrret
種類: STRRET*
STRRET 構造体へのポインター。
[in] pidl
種類: PCUITEMID_CHILD
詳細を取得するアイテムの PIDL。
[out] pvar
型: VARIANT*
この関数が戻るとき、 には初期化された VARIANT 構造体が含まれます。
戻り値
種類: HRESULT
この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。
注釈
VT_BSTRバリアントを作成します。
メモ この関数は、 STRRET コンテンツに使用されるリソースを解放します。
例
大規模なプログラムの一部として含める次の例では、 InitVariantFromStrRet の使用方法を示します。
// STRRET strret;
// PCUITEMID_CHILD pidl;
// Assume variables strret and pidl are initialized and valid.
VARIANT var;
HRESULT hr = InitVariantFromStrRet(strret, pidl, &var);
if (SUCCEEDED(hr))
{
// var now is valid and has type VT_BSTR.
VariantClear(&var);
}
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | WINDOWS XP と SP2、Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2003 SP1 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | propvarutil.h |
| Library | Propsys.lib |
| [DLL] | Propsys.dll (バージョン 6.0 以降) |
| 再頒布可能パッケージ | Windows デスクトップ検索 (WDS) 3.0 |