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*

Optional. パラメーターを入力および出力として解析関数に渡すために使用されるバインド コンテキストへのポインター。 これらの渡されたパラメーターは、多くの場合、データ ソースに固有であり、データ ソースの所有者によって文書化されます。 たとえば、ファイル システム データ ソースは、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 でのコーディング エラーの可能性がなくなります。

Requirements