SHCreateItemFromParsingName 関数 (shobjidl_core.h)

解析名からシェル項目オブジェクトを作成して初期化します。

構文

SHSTDAPI SHCreateItemFromParsingName(
  [in]           PCWSTR   pszPath,
  [in, optional] IBindCtx *pbc,
  [in]           REFIID   riid,
  [out]          void     **ppv
);

パラメーター

[in] pszPath

種類: PCWSTR

表示名へのポインター。

[in, optional] pbc

型: IBindCtx*

省略可能。 パラメーターを入力として渡し、解析関数に出力するために使用されるバインド コンテキストへのポインター。 これらの渡されたパラメーターは、多くの場合、データ ソースに固有であり、データ ソースの所有者によって文書化されます。 たとえば、ファイル システム データ ソースは、STR_FILE_SYS_BIND_DATA バインド コンテキスト パラメーターを使用して、解析される名前を (WIN32_FIND_DATA構造体として) 受け入れます。

STR_PARSE_PREFER_FOLDER_BROWSING を渡して、可能な場合はファイル システム データ ソースを使用して URL が解析されることを示すことができます。 CreateBindCtx を使用してバインド コンテキスト オブジェクトを構築し、IBindCtx::RegisterObjectParam を使用して値を設定します。 これらの完全な一覧については、「 バインド コンテキスト文字列キー 」を参照してください。 このパラメーターの使用例については、「 パラメーターによる解析のサンプル 」を参照してください。

解析関数にデータが渡されないか、解析関数から受け取られるデータがない場合、この値は NULL にすることができます。

[in] riid

型: REFIID

ppv を介して取得するインターフェイスの IID への参照 (通常はIID_IShellItemまたはIID_IShellItem2)。

[out] ppv

型: void**

このメソッドが正常に返されると、 riid で要求されたインターフェイス ポインターが含まれます。 これは通常、 IShellItem または IShellItem2 です。

戻り値

型: HRESULT

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

解説

riid パラメーターと ppv パラメーターをパッケージ化するには、Objbase.h で定義されているIID_PPV_ARGS マクロを使用することをお勧めします。 このマクロは、ppv の値によって指されるインターフェイスに基づいて正しい IID を提供します。これにより、riid でコーディング エラーが発生し、予期しない結果が発生する可能性がなくなります。

要件

サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	shobjidl_core.h (Shobjidl.h を含む)
[DLL]	Shell32.dll