SHCreateItemFromParsingName 函数 (shobjidl_core.h)
创建并初始化分析名称中的 Shell 项对象。
语法
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 bind 上下文参数接受 (分析的名称作为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 错误代码。
注解
建议使用 objbase.h 中定义的 IID_PPV_ARGS 宏打包 riid 和 ppv 参数。 此宏根据 ppv 中的 值指向的接口提供正确的 IID,这消除了 riid 中可能导致意外结果的编码错误的可能性。
要求
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | shobjidl_core.h (包括 Shobjidl.h) |
DLL | Shell32.dll |