StrRetToBSTR 関数 (shlwapi.h)

IShellFolder::GetDisplayNameOf によって返される、文字列を含む、または文字列を指す STRRET 構造体を受け入れ、その文字列を BSTR として返します。

構文

LWSTDAPI StrRetToBSTR(
  [in, out] STRRET          *pstr,
  [in]      PCUITEMID_CHILD pidl,
  [out]     BSTR            *pbstr
);

[in, out] pstr

STRRET 構造体へのポインター。関数が戻ると、このポインターは有効な時間が長くなります。

[in] pidl

種類: PCUITEMID_CHILD

親フォルダーに関連するファイルオブジェクトまたはサブフォルダーを一意に識別する ITEMIDLIST へのポインター。この値には NULL を指定できます。

[out] pbstr

種類: BSTR*

変換された文字列を受け取る BSTR 型の変数へのポインター。

型: HRESULT

この関数が成功すると、 S_OKが返されます。そうでない場合は、HRESULT エラーコードを返します。

pstr が指す STRRET 構造体の uType メンバーがSTRRET_WSTRに設定されている場合、その構造体の pOleStr メンバーは、戻り時に解放されます。